gsd-ingest-docs

Ingest ADR, PRD, SPEC, and DOC files into .planning/ workflows.

Updated Jan 28, 2025
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-ingest-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-ingest-docs
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-ingest-docs
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-ingest-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingest planning documents from ADRs, PRDs, SPECs, and DOCs to bootstrap or merge a .planning/ setup across a repository, synthesizing context and surfacing conflicts for resolution.

Core Features & Use Cases

  • Ingest multiple planning document types from standard locations (docs/adr/, docs/prd/, docs/specs/, docs/rfc/ and root-level ADR-PRD-SPEC-RFC-*.md) and classify them in parallel.
  • Auto-synthesize conflicts using the precedence ADR > SPEC > PRD > DOC, producing INGEST-CONFLICTS.md with categorized results and gating to prevent writes when blockers exist.
  • Bootstrap a new .planning/ with PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md, or merge into an existing planning by appending phases and requirements.
  • Support optional manifest input to control document precedence and routing.

Quick Start

Run the ingest-docs workflow with the path to your repository to bootstrap or merge .planning/.

Frequently Asked Questions about gsd-ingest-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap a .planning setup from scattered PRDs and ADRs?

To bootstrap a .planning setup from scattered PRDs and ADRs, ingest planning documents from standard locations to auto-generate PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md. The workflow processes multiple doc types in parallel and classifies them by precedence.

What happens when conflicting requirements exist across SPECs and PRDs?

When conflicting requirements exist across SPECs and PRDs, the ingest workflow auto-synthesizes conflicts using the precedence ADR > SPEC > PRD > DOC. It outputs INGEST-CONFLICTS.md with categorized results and gates writes to prevent blockers from proceeding.

Can I merge new architecture decision records into an existing planning setup?

You can merge new architecture decision records into an existing planning setup by running the ingest workflow. It appends new phases and requirements to your current .planning/ directory instead of overwriting it, preserving existing project state.

How many planning documents can I process in a single ingest run?

You can process up to 50 planning documents in a single ingest run. The workflow enforces a 50-doc cap per execution to manage processing loads when classifying standard locations like docs/specs/ and root-level RFC files.

Do I need a manifest to control document precedence during planning ingestion?

You do not need a manifest to control document precedence during planning ingestion, as the default ADR > SPEC > PRD > DOC hierarchy applies automatically. However, providing an optional manifest input allows you to manually control routing and precedence.

What is the best way to consolidate RFCs and SPECs into a single roadmap?

The best way to consolidate RFCs and SPECs into a single roadmap is to run a parallel ingest workflow that classifies documents by precedence. This synthesizes scattered context and outputs a unified ROADMAP.md alongside your core planning files.