tracedocs

Generate evidence-grounded Markdown documentation and a machine-readable index.json from any codebase.

3.4k|487|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/davepoon/buildwithclaude --skill tracedocs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tracedocs
Source: https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/tracedocs
Command: npx skills add https://github.com/davepoon/buildwithclaude --skill tracedocs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documenting an unfamiliar codebase is slow and error-prone, and AI-generated docs often invent deployment steps or configuration details that do not exist. This Skill produces documentation where every operational claim cites its source file and carries a confidence label, so gaps are recorded instead of hallucinated.

Core Features & Use Cases

  • Evidence-grounded documentation: Generates overview, operation, deployment, learning, architecture, API/data, troubleshooting, and maintenance manuals where each claim cites a source file with a Verified / Inferred / Unknown / Needs confirmation label.
  • Machine-readable index.json: Produces an index.json manifest plus an _evidence/ map (source map, assumptions, generation log) so AI agents can consume the documentation package.
  • Quality checks: Verifies that referenced paths exist, commands are sourced, no secret values leak, and undocumented gaps are explicitly noted.
  • Use Case: Point it at a newly inherited repository to produce a study-docs/ onboarding package whose deployment instructions are traceable to actual config files, with missing pieces flagged rather than fabricated.

Quick Start

Use tracedocs to generate evidence-grounded study docs for this repository and write the output to study-docs/.

Frequently Asked Questions about tracedocs

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

FAQPage Schema
How do I generate documentation for an unfamiliar codebase?

Run tracedocs against the repository and it scans the stack, scripts, entry points, environment variables, and deploy signals, then writes a study-docs package of Markdown manuals plus an index.json. Every operational claim cites its source file with a confidence label.

How do I create AI-agent-readable documentation from a repository?

tracedocs produces a machine-readable index.json manifest alongside the Markdown manuals, plus an _evidence/ directory containing the source map, assumptions, and generation log. AI agents can consume this package directly for knowledge handoff.

Can AI-generated docs invent deployment steps that do not exist?

Many tools do, but tracedocs never invents deployment steps. Each claim is labeled Verified, Inferred, Unknown, or Needs confirmation, and missing configuration is recorded as an explicit gap such as no deployment configuration found in the repo.

What output files does tracedocs generate?

It writes a study-docs/ package containing manuals numbered 00 through 10 covering overview, operation, deployment, learning, architecture, API/data, troubleshooting, and maintenance, plus index.json and an _evidence/ directory.

Does tracedocs check the quality of the generated documentation?

Yes, it runs a quality check confirming that referenced paths exist, commands are sourced from the repo, no secret values appear in the output, and all documentation gaps are explicitly recorded.