docs-writer

Generate decision logs, feature documents, and flow documents from code changes and project plans.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/ps-carvalho/spavn-agents --skill docs-writer-ps-carvalho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-writer
Source: https://github.com/ps-carvalho/spavn-agents/tree/main/.opencode/skills/docs-writer
Command: npx skills add https://github.com/ps-carvalho/spavn-agents --skill docs-writer-ps-carvalho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the generation of essential documentation based on code changes and project plans, ensuring that project knowledge is captured and maintained efficiently.

Core Features & Use Cases

  • Automated Documentation: Generates decision logs, feature descriptions, and process flows.
  • Contextual Generation: Analyzes code diffs, implementation summaries, and project plans to create relevant documentation.
  • Use Case: After a new feature is implemented and passes quality gates, this Skill automatically creates a decision document detailing architectural choices and a feature document explaining the new functionality.

Quick Start

Generate documentation for the recent code changes.

Frequently Asked Questions about docs-writer

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

FAQPage Schema
How do I generate documentation automatically from code changes?

You can generate documentation automatically by analyzing code diffs, implementation summaries, and project plans. This process creates decision logs, feature documents, and flow documents to capture project knowledge after code changes pass quality gates.

What types of documentation can I create from implementation context?

From implementation context, you can create decision logs detailing architectural choices, feature documents explaining new functionality, and process flow documents. These types ensure comprehensive project knowledge management based on code changes.

How do I automate decision log creation after a feature passes quality gates?

To automate decision log creation, provide the implementation context and code changes to a documentation generation tool. It analyzes the context to produce a decision document detailing architectural choices made during the feature implementation.

Does automated documentation generation work with existing project plans?

Yes, automated documentation generation works with existing project plans by analyzing them alongside code changes and implementation summaries. It uses this combined context to produce accurate feature descriptions and process flows.

What is the best way to maintain project knowledge without manual writing?

The best way to maintain project knowledge without manual writing is using automated code generation tools. They analyze code changes and project plans to continuously generate and index essential documentation, ensuring knowledge is captured efficiently.

Do I need specific tools to save and index generated feature documents?

Yes, you need specific documentation tools to save and index generated feature documents. The generation process requires these tools to ensure the automated output is properly stored and searchable within your project's knowledge management system.