From appmaker
Break PRD into vertical-slice backlog items (tracer bullets). Each slice cuts ALL layers end-to-end. Adopts Matt Pocock to-issues 1:1 plus AppMaker extensions execution_class, traces_to per AC, YAML front-matter, cycle detection, local backlog default. Use when PRD is ready and user wants to plan implementation work.
How this skill is triggered — by the user, by Claude, or both
Slash command
/appmaker:decomposeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Break PRD into independently-grabbable backlog items using **vertical slices** (Matt Pocock tracer bullets). Adopts `to-issues` (canonical, MIT) plus AppMaker extensions.
Break PRD into independently-grabbable backlog items using vertical slices (Matt Pocock tracer bullets). Adopts to-issues (canonical, MIT) plus AppMaker extensions.
Templates referenced: appmaker/templates/backlog-item-template.md and appmaker/templates/decomposition-template.md.
/appmaker:decompose (latest PRD) or /appmaker:decompose <folder>start on feature workflow continuation post-PRDprd.md present in feature folderDecomposition slices benefit from knowing past architectural touch maps + known integration gotchas + already-shipped features. Read BEFORE drafting slice table.
# Pre-flight wiki cat — respects wiki_preflight_mode config flag (v0.2.12)
WIKI_MODE=$(grep '^wiki_preflight_mode:' appmaker/config.yaml 2>/dev/null | awk '{print $2}')
WIKI_MODE="${WIKI_MODE:-auto}"
if [ "$WIKI_MODE" != "never" ]; then
for page in architecture feature-index integration-gotchas; do
f="appmaker/memory/wiki/${page}.md"
# Skip missing or header-only files (≤5 lines = seed stub, not real content yet) — saves tokens on fresh projects
if [ -f "$f" ] && [ "$(wc -l < "$f")" -gt 5 ]; then
echo "─── $f ───" && cat "$f"
fi
done
fi
Cite as per wiki/integration-gotchas.md: <known issue> when slice scope or human_required classification is influenced. If feature-index.md shows prior slicing patterns for similar work (e.g., "tracer-first → rules → recompute" elsewhere), favor consistency. Don't blindly copy past structure if PRD shape differs — flag the divergence in decomposition.md Notes.
If invoked without arg, find latest appmaker/features/<NNN-slug>/ with prd.md and no existing decomposition.md. Confirm via AskUserQuestion.
appmaker/features/<NNN>/prd.md — primary inputappmaker/features/<NNN>/spike-output/ if exists (snippets for prototype exception)appmaker/glossary.md — canonical termsappmaker/constitution.md — rulesappmaker/memory/index.md + relevant wiki pages — prior architecture/testing/domain lessonsappmaker/templates/backlog-item-template.md + appmaker/templates/decomposition-template.md — output formats/appmaker:context "<feature topic>".Each slice MUST:
Per slice, classify execution_class:
human_required — needs human interaction (architectural decision, design review, money/legal/security/identity per constitution rule 6)autonomous — can be implemented and merged without human gateconditional — depends on runtime check (rare)Prefer autonomous unless constitution rule 6 applies.
Per slice, identify:
Present breakdown as numbered list. Use AskUserQuestion:
execution_class markers correct?Iterate until user approves.
Build directed graph of blocked_by. Run topological sort. If cycle → refuse to write, surface cycle to user.
For each approved slice, write appmaker/backlog/NNN-<slug>.md (using appmaker/templates/backlog-item-template.md).
Plus write appmaker/features/<NNN>/decomposition.md (using appmaker/templates/decomposition-template.md).
Publish in dependency order (blockers first).
Tier 1 — Deterministic stub extraction:
bash appmaker/hooks/glossary-extract.sh "appmaker/features/<NNN>/decomposition.md"
Verifiable bash that appends candidate-term stubs to glossary. Idempotent.
Tier 2 — Semantic review: MAY invoke /appmaker:glossary via Skill tool if conversation context can resolve stubs. Otherwise stubs remain for user's explicit /appmaker:glossary invocation. Best-effort, NOT deterministic.
✓ Decomposition: appmaker/features/003-add-dark-mode/decomposition.md
✓ Backlog items: 4 created (IDs 008-011)
- 008-theme-context-setup (autonomous)
- 009-toggle-component (autonomous, blocked_by: 008)
- 010-storage-persistence (autonomous, blocked_by: 008)
- 011-system-pref-detection (human_required, blocked_by: 008)
✓ Cycle check: PASS
✓ Coverage: 12/12 PRD criteria mapped (no orphans)
✓ Context packets: 1 linked
✓ Glossary: +2 terms
Suggested next: /appmaker:tdd 008 (or autonomous via /appmaker:afk if Layer 4)
execution_class per slice mandatory. Default autonomous unless constitution rule 6.traces_to per AC mandatory. Every AC traces to PRD criterion. No orphans./appmaker:sync-github adapter.autonomous. Be conservative./appmaker:tdd next.Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub paweldobrzynski/appmaker --plugin appmaker