structural-doc-batch

Generate eight structural project documents from source code and commit them to git.

2|Updated May 10, 2026
One-click install
npx skills add https://github.com/freedomw1987/tree_monstor --skill structural-doc-batch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structural-doc-batch
Source: https://github.com/freedomw1987/tree_monstor/tree/main/skills/structural-doc-batch
Command: npx skills add https://github.com/freedomw1987/tree_monstor --skill structural-doc-batch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Software projects often ship with missing structural documentation, violating SOUL.md red lines that require 8 specific documents (PROJECT-OVERVIEW, PRD, ADR, API, TEST-COVERAGE, TECH-DEBT, QA-TRACKER, REGRESSION-GUARD) to exist and be committed to git before merge. This Skill automates the batch generation of all required documents from existing source code, eliminating hours of manual documentation work while ensuring compliance.

Core Features & Use Cases

  • Batch Document Generation: Creates all 8 structural documents plus optional retros in a single operation, derived directly from source code, git history, and existing schemas.
  • Source-First Derivation: All content is extracted from actual codebase artifacts (routes, Prisma models, test files, commit logs) rather than hallucinated, ensuring accuracy and alignment with reality.
  • Git-Safe Workflow: Includes mandatory working tree inspection and precise staging to prevent accidental commits of unrelated changes or data loss from manual file deletions.
  • Use Case: When a developer says "I need to補一下文檔" or "This project is missing PROJECT-OVERVIEW and PRD", this Skill generates the complete documentation batch, commits it with a detailed message, and proposes next sprint test actions.

Quick Start

Use the structural-doc-batch skill to analyze your project source code and generate all 8 required structural documents in a single batch operation, then commit them to git with a single commit message.

Frequently Asked Questions about structural-doc-batch

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

FAQPage Schema
How do I generate missing project documentation like PRD and tech-debt trackers from existing code?

You can batch-generate structural project documentation like PRD and tech-debt trackers by deriving content source-first from existing codebase artifacts such as routes, schemas, git history, and test files. This ensures all generated documents align with actual implementation rather than being manually written.

What is the best way to automate project overview and API documentation creation before shipping?

Automating project overview and API documentation creation is best handled by batch-generating all required structural documents in a single operation. The process extracts content directly from source code artifacts and stages them with precise git operations to prevent working tree data loss.

How do structural documents prevent ship-blocking compliance issues in software projects?

Structural documents prevent ship-blocking compliance issues by satisfying requirements for 8 specific documents that must exist and be committed to git before a merge. Batch-generating these documents eliminates manual work and ensures missing files do not block deployment.

Does batch documentation generation work with any software project or only specific frameworks?

Batch documentation generation applies to any software project requiring documentation alignment. It derives content from standard codebase artifacts including routes, Prisma models, test files, and commit logs, making it framework-agnostic as long as source artifacts exist.

How to safely commit generated regression-guard and QA-tracker files without losing working tree changes?

To safely commit generated regression-guard and QA-tracker files, the workflow includes mandatory working tree inspection and precise staging. This prevents accidental commits of unrelated changes and avoids data loss from manual file deletions during the batch operation.

What specific documents are required to satisfy structural documentation compliance before merge?

Structural documentation compliance requires 8 specific documents: PROJECT-OVERVIEW, PRD, ADR, API, TEST-COVERAGE, TECH-DEBT, QA-TRACKER, and REGRESSION-GUARD. These must exist and be committed to git before merge to avoid ship-blocking violations.