gsd-ingest-docs
SkillDev toolsLets your agent set up or update a .planning folder from existing docs like ADRs, PRDs, and specs in a repo.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the gsd-ingest-docs skill
About this capability
Bootstrap or merge a .planning/ setup from existing ADRs, PRDs, SPECs, and docs in a repo.
What this skill tells your AI
The instructions your AI receives, as published by open-gsd/gsd-core in skills/gsd-ingest-docs/SKILL.md and read by ahel’s review.
- Net-new bootstrap (
--mode new, default when.planning/is absent): produces PROJECT.md + REQUIREMENTS.md + ROADMAP.md + STATE.md from synthesized doc content, delegating final generation togsd-roadmapper. - Merge into existing (
--mode merge, default when.planning/is present): appends phases and requirements derived from the ingested docs; hard-blocks any contradiction with existing locked decisions.
Auto-synthesizes most conflicts using the precedence rule ADR > SPEC > PRD > DOC (overridable via manifest). Surfaces unresolved cases in .planning/INGEST-CONFLICTS.md with three buckets: auto-resolved, competing-variants, unresolved-blockers. The BLOCKER gate from the shared conflict engine prevents any destination file from being written when unresolved contradictions exist.
Inputs: directory-convention discovery (docs/adr/, docs/prd/, docs/specs/, docs/rfc/, root-level {ADR,PRD,SPEC,RFC}-*.md), or an explicit --manifest <file> YAML listing {path, type, precedence?} per doc.
v1 constraints: hard cap of 50 docs per invocation; --resolve interactive is reserved for a future release.
<execution_context>
@/.claude/gsd-core/workflows/ingest-docs.md
@/.claude/gsd-core/references/ui-brand.md
@/.claude/gsd-core/references/gate-prompts.md
@/.claude/gsd-core/references/doc-conflict-engine.md
</execution_context>
Signals
- GitHub stars
- 9k
- Forks
- 680
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
gsd-ingest-docs- Source
- github.com/open-gsd/gsd-core