Creates aiwf planning entities with allocated ids, frontmatter, and atomic git commits.
npx skills add https://github.com/23min/aiwf --skill aiwf-add-23min
Please help me install this Agent Skill. Skill: aiwf-add Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-add Command: npx skills add https://github.com/23min/aiwf --skill aiwf-add-23min
aiwf add verb so id allocation, frontmatter shape, body scaffolding, and the trailered git commit all happen mechanically. ## Core Features & Use Cases - Entity creation for six kinds: Allocate and create epics, milestones, ADRs, gaps, decisions, and contracts with kind-specific required flags and stable ids (E-NNNN, M-NNNN, ADR-NNNN, G-NNNN, D-NNNN, C-NNNN). - Acceptance criteria under milestones: Add one or many ACs atomically with repeated --title flags and positional --body-file pairing, seeded at the pre-cycle empty TDD phase. - Body content in the create commit: Pass --body or --body-file (including stdin) so real prose lands in the same atomic commit, avoiding untrailered follow-up edits; born-complete kinds (gap, decision, ADR, contract) refuse empty load-bearing sections unless --force --reason is given. - Milestone dependency edges: Declare depends_on DAG edges at allocation time or post-allocation via aiwf milestone depends-on, with replace-not-append semantics. - Use Case: While reviewing a design doc with your AI assistant, you discover a defect. The assistant drafts the gap body and runs aiwf add gap --title "Retry loop spins forever" --body-file gap-body.md, producing a validated entity file and one trailered commit. ## Quick Start Ask the assistant to add a new aiwf entity, for example: create a gap titled "Retry loop spins forever" with the body describing what is missing and why it matters.High-intent search queries and answers about installing and using this skill.
Run aiwf add <kind> --title "<title>" with the kind-specific flags, such as --epic and --tdd for milestones or --body-file for gaps and decisions. The verb allocates the next free id, writes frontmatter, validates the projected tree, and creates one trailered git commit.
Pass repeated --title flags to aiwf add ac M-NNNN; each title gets a consecutive AC id in one atomic commit. You can pair each title with a --body-file positionally, but the counts must match or the batch is refused before any disk work.
Gap, decision, ADR, and contract are born-complete kinds with no draft phase, so aiwf add refuses a create whose required body sections are empty. Pass real prose via --body or --body-file, or override with --force --reason "<justification>".
Allocation scans the working tree, local branches, remote-tracking refs, and the configured trunk ref, so most collisions are avoided. Use aiwf add --fetch in separate clones and push promptly; unresolved collisions are fixed with aiwf reallocate.
Always use the verb for creating entities or changing tree shape; hand-written files under work/ bypass id allocation, validation, and commit trailers, and aiwf check reports them as provenance-untrailered-entity-commit or unexpected-tree-file findings.
bravrosUpdates git hooks in an existing project to the latest Bravros template version.
davepoonCreates pull requests and tracks merges after verification passes.
headwater-aiDrafts governed documentation documents through the headwater engine's scaffolding verb.
endorphin-aiManage project documentation and work items using markdown files with Git.