name: orchestra-registry-foundation description: Design and maintain the Phase 01 Orchestra YAML registry, Rust core types, atomic save/load, and CLI bootstrap commands.

Objective

Build or modify the Orchestra registry as the single source of truth.

Use This Skill When

• Creating or changing Codebase, Task, Skill, Subagent, or AgentConfig schema.
• Implementing orchestra init, project listing, or registry validation.
• Debugging YAML parse/save failures, file permissions, or atomic writes.

Procedure

1. Update core domain types first, then serialization, then CLI wiring.
2. Keep all path handling with PathBuf and return typed errors.
3. Use atomic write in target directory (.tmp then rename).
4. Validate roundtrip serde for all changed structs.
5. Verify Unix permission targets (dirs 0700, YAML 0600).

Guardrails

• Never use unwrap()/expect() in library crates.
• Keep registry deterministic and human-readable.
• Emit actionable parse errors with file path and line context.

Done Criteria

• cargo build --workspace passes.
• cargo clippy --workspace -- -D warnings passes.
• Roundtrip and error-path tests pass for registry flows.