agentpack-dev

This skill is for developing the agentpack repo (not for operating agentpack on another project).

Canonical docs (read first)

• docs/CODEX_EXEC_PLAN.md (AI-first execution roadmap)
• docs/SPEC.md (authoritative implementation contract)
• docs/JSON_API.md + docs/ERROR_CODES.md (--json contract + stable error codes)

Spec-driven workflow (OpenSpec)

• Read: openspec/AGENTS.md and openspec/project.md
• Create proposal: openspec/changes/<change-id>/ (verb-led kebab-case)
• Validate: openspec validate <change-id> --strict --no-interactive
• After merge: archive via openspec archive <change-id> --yes (separate PR)

Local verification

• cargo fmt --all -- --check
• cargo clippy --all-targets --all-features -- -D warnings
• cargo test --all --locked