harness-step2-fill-docs

Populate docs/ with architecture, conventions, and tech decision files from codebase analysis.

132|25|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/simbajigege/book2skills --skill harness-step2-fill-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-step2-fill-docs
Source: https://github.com/simbajigege/book2skills/tree/main/skills/harness-step2-fill-docs
Command: npx skills add https://github.com/simbajigege/book2skills --skill harness-step2-fill-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates turning a skeleton docs/ into substantive documentation by reading codebase structure and extracting architectural knowledge, naming conventions, and technology choices.

Core Features & Use Cases

  • Populate ARCHITECTURE.md with module responsibilities, dependency rules, and data flows.
  • Populate CONVENTIONS.md with file naming, variable naming, and directory organization patterns, backed by code examples.
  • Populate TECH_DECISIONS.md with rationale for major libraries/frameworks, with notes where inference is uncertain.
  • Populate QUALITY.md with a Definition of Done and code-review checklist.
  • Populate exec-plans/tech-debt-tracker.md with discovered issues like duplicate code or TODOs.
  • Use case: after AGENTS.md setup, refresh docs to reflect current code and enable agents to understand the project.

Quick Start

Run this skill after AGENTS.md and a docs skeleton exist to fill the docs with real content.

Frequently Asked Questions about harness-step2-fill-docs

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

FAQPage Schema
How do I generate architecture and conventions documentation from existing code automatically?

To generate architecture and conventions documentation automatically, this Skill deep-reads your codebase to populate docs/ files like ARCHITECTURE.md and CONVENTIONS.md with inferred module responsibilities, dependency rules, and naming patterns backed by code examples.

What is the best way to track tech debt discovered during code analysis?

The best way to track tech debt from code analysis is using a structured tracker; this Skill populates exec-plans/tech-debt-tracker.md by extracting discovered issues like duplicate code and TODOs directly from your codebase structure.

How do I document technology decisions and library rationale for a software project?

To document technology decisions and library rationale, this Skill populates TECH_DECISIONS.md with inferred reasoning for major frameworks and libraries, explicitly labeling uncertain items as pending review for human confirmation.

What do I need to set up before automating project documentation extraction?

Before automating project documentation extraction, you need an AGENTS.md file and an existing docs/ skeleton in place; this Skill then reads the codebase to fill those skeleton files with substantive architectural and convention content.

How does the documentation generation process handle uncertain or inferred technical details?

The documentation generation process handles uncertain technical details by labeling inferred items as pending review and surfacing them for human confirmation, ensuring all reference-backed documentation remains accurate and verifiable.

Can I establish a Definition of Done and code review checklist from my codebase structure?

Yes, you can establish a Definition of Done and code review checklist from your codebase; this Skill populates QUALITY.md with these standards by analyzing your project's existing code structure and engineering patterns.