orca-build

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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

- Task or spec

## Optional Inputs

- Plan
- Test commands
- Existing artifacts

## Exact Workflow

1. Confirm the approved scope from the GitHub issue and Project (default), or from an explicitly requested Mission-only record.
2. 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.
3. Read relevant files before editing.
4. Preserve user changes and existing patterns.
5. Make the smallest coherent change that satisfies the phase.
6. 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.
7. 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.
8. Run appropriate verification.
9. 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 GitHub issue 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.

From henryvn27/orca-framework, MIT.

More from henryvn27/orca-framework