pto-isa-dev

Category: Development & Coding | Uploader: hw-native-sys | Downloads: 0 | Version: v1.0（Latest）

Work effectively in PTO-ISA: choose the right backend, run CPU/SIM/NPU flows, trace instruction constraints, understand A2/A3 vs A5 differences, align with PTO-AS, and debug failures.

Changelog: Source: GitHub https://github.com/hw-native-sys/pto-isa

Directory Structure

Current level: tree/main/.claude/skills/pto-isa-dev/

📁 references/
- 📄 build-and-run.md 3.4 KB
- 📄 constraints-and-platforms.md 3.5 KB
- 📄 debugging.md 3.1 KB
📄 SKILL.md 3.2 KB

SKILL.md

---
name: pto-isa-dev
description: Work effectively in PTO-ISA: choose the right backend, run CPU/SIM/NPU flows, trace instruction constraints, understand A2/A3 vs A5 differences, align with PTO-AS, and debug failures.
---

# PTO-ISA Development

Use this skill when working in `pto-isa` with Claude Code, Codex, or a similar repository-aware coding agent on instruction behavior, backend portability, tests, docs, or tooling integration.

## Quick Start

- Start from CPU-SIM unless the task is explicitly hardware-only.
- Use the smallest reproducer first: one testcase, one gtest filter, one backend.
- Treat public docs and headers as the ISA contract, then confirm backend-specific legality in the implementation.
- When assembly or bytecode is involved, cross-check PTO-AS docs before changing backend code.

## Core Workflow

- Orient with:
  - [README.md](../../../README.md)
  - [docs/agent.md](../../../docs/agent.md)
  - [docs/getting-started.md](../../../docs/getting-started.md)
  - [include/README.md](../../../include/README.md)
- Pick the execution lane:
  - CPU correctness and portability: [references/build-and-run.md](references/build-and-run.md)
  - Backend legality and platform differences: [references/constraints-and-platforms.md](references/constraints-and-platforms.md)
  - PTO-AS linkage and failure analysis: [references/debugging.md](references/debugging.md)
- Validate with the narrowest command that proves the change.
- Only scale up to full suites after the focused reproducer passes.

## Source of Truth

- Public ISA/API surface:
  - [include/pto/common/pto_instr.hpp](../../../include/pto/common/pto_instr.hpp)
  - [docs/PTO-Virtual-ISA-Manual.md](../../../docs/PTO-Virtual-ISA-Manual.md)
  - [docs/isa/README.md](../../../docs/isa/README.md)
- Backend implementations:
  - [include/pto/cpu](../../../include/pto/cpu)
  - [include/pto/npu/a2a3](../../../include/pto/npu/a2a3)
  - [include/pto/npu/a5](../../../include/pto/npu/a5)
- Toolchain and assembly contract:
  - [docs/assembly/README.md](../../../docs/assembly/README.md)
  - [docs/assembly/PTO-AS.md](../../../docs/assembly/PTO-AS.md)
  - [docs/assembly/PTO-AS.bnf](../../../docs/assembly/PTO-AS.bnf)

## Working Rules

- Prefer CPU-SIM first for new behavior, regressions, and docs examples.
- Use `-v a3` for the shared A2/A3 backend and `-v a5` for A5-specific behavior.
- Assume backend constraints matter unless the virtual ISA explicitly says otherwise.
- When documentation is touched, keep it hub-and-spoke: short overview here, deeper detail in reference docs.
- If an instruction works on one backend but not another, document whether it is:
  - virtual-ISA legal but backend-limited
  - backend-specific by design
  - an implementation gap

## Deliverables This Skill Supports

- Implement or debug a PTO instruction on CPU-SIM, A2/A3, or A5.
- Add or update tests in CPU-SIM, costmodel, or NPU ST.
- Trace why an instruction shape, dtype, or location is rejected.
- Compare PTO source, PTO-AS text, and backend lowering expectations.
- Update docs while keeping claims aligned with code.

## References

- [references/build-and-run.md](references/build-and-run.md)
- [references/constraints-and-platforms.md](references/constraints-and-platforms.md)
- [references/debugging.md](references/debugging.md)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

pto-isa-dev

Directory Structure

SKILL.md

Report

Notice