| name | orca-build |
| description | Implement planned changes with scoped edits, verification, and respect for existing project patterns. |
ORCA Framework Build
What This Skill Is
The implementation workflow for ORCA Framework.
Trigger
Use when the user has asked for code, docs, scripts, or repository changes.
Do Not Trigger
Do not use when the user only wants brainstorming, review, or research.
Required Inputs
Optional Inputs
- Plan
- Test commands
- Existing artifacts
Exact Workflow
- Confirm the approved scope from Linear or the opt-out record.
- Before non-trivial repo edits, follow
docs/version-control.md: inspect repo root/status/current/default branch, preserve unrelated dirty work, and move implementation to a scoped non-protected branch.
- Read relevant files before editing.
- Preserve user changes and existing patterns.
- Make the smallest coherent change that satisfies the phase.
- For user-facing async data, include loading, empty, and error states; prefer skeleton frames when the eventual layout is known and the surface would otherwise look blank.
- If the user wants the official wrapped execution pack and Superpowers is the stronger fit, route that segment there instead of reproducing the upstream workflow locally.
- Run appropriate verification.
- Record what changed and what could not be verified in the durable record, including branch or PR links when repo work changed files.
Expected Outputs
- Completed file changes
- Verification notes
- Updated artifacts or Linear comments when applicable
Quality Bar
The work should be maintainable by the repo's existing standards and should not leave hidden scaffolding.
User-facing async work should not feel visually broken while data is in flight.
Common Failure Modes
- Rewriting unrelated systems.
- Implementing directly on a protected branch.
- Skipping verification.
- Leaving generated claims unsupported.
Relationship To Other ORCA Framework Skills And Commands
Used by orca-build; may pair with orca-superpowers; followed by review and QA skills.