project-document-discovery

Classifies a project idea and generates a proportional, capability-scoped document manifest as JSON.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill project-document-discovery-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-document-discovery
Source: https://github.com/bm629/agent-skills/tree/main/skills/project-document-discovery
Command: npx skills add https://github.com/bm629/agent-skills --skill project-document-discovery-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding which documents a software project actually needs is error-prone: teams either over-produce a fixed SDLC taxonomy or skip load-bearing artifacts like the PRD. This Skill turns a project idea into a proportional, capability-scoped document plan with producers, skills, tools, and dependency edges for every document. ## Core Features & Use Cases - 10-dimension classification: Classifies the project across archetype, domain, regulatory, scale, security, integrations, UI, data/ML, infrastructure, and business clusters, then derives 10 validator-checked prior-art trigger booleans. - Capability identification: Applies a 4-signal algorithm (reference architectures, domain events, domain nouns, jobs-to-be-done) plus three sizing tests to identify 4-10 product capability areas. - Manifest fan-out: Generates shared and per-capability document entries (feature specs, API specs, data models, wireframes, model cards) with author/reviewer role pairs, authoring/reviewing skill pairs, and an acyclic depends_on DAG. - Amend mode: Re-tailors an existing capability-map.yaml and manifest.yaml on a change request using a T1-T5 change taxonomy with a human gate for structural splits and merges. - Use Case: Given an idea.md for a consumer e-commerce web app, produce a three-key JSON payload (capability_map, product_capabilities, manifest) that a caller writes to capability-map.yaml and manifest.yaml to drive downstream document production. ## Quick Start Use project-document-discovery on my idea.md to decide which documents this project needs and return the capability map and document manifest JSON.

Frequently Asked Questions about project-document-discovery

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

FAQPage Schema
How do I decide which documents a software project needs?

Provide an idea.md describing the project; the skill classifies it across 10 dimensions, identifies capability areas, and returns a proportional document manifest. The output is a three-key JSON the caller writes to capability-map.yaml and manifest.yaml.

How to plan SDLC documentation proportionally for a small project?

The skill sizes the document set to the project archetype rather than applying a fixed taxonomy. A thin CLI tool gets few documents while a consumer web app gets PRD, feature specs, design docs, and delivery documents, with load-bearing documents never cut.

Does project-document-discovery write the documents themselves?

No. It is discovery only: it decides which documents are needed, their producer roles, skills, tools, and dependencies. Authoring each document is handled by separate per-document authoring skills listed in the manifest.

Can I update an existing document manifest when the project changes?

Yes. Amend mode takes the existing capability-map.yaml, manifest.yaml, and a change request, classifies the delta as T1-T5, and applies only the change-scoped updates. Structural splits or merges (T4/T5) require human confirmation.

What output format does the document discovery skill return?

It returns a single three-key JSON object with capability_map, product_capabilities, and manifest keys. The skill never writes files or assumes a scope_root; the caller writes capability-map.yaml and manifest.yaml from the payload.