doc

Document research findings into ProductSpecification markdown files with cross-references.

2|1|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/is-ivanov/rpm-ddd --skill doc-is-ivanov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc
Source: https://github.com/is-ivanov/rpm-ddd/tree/main/.opencode/skills/doc
Command: npx skills add https://github.com/is-ivanov/rpm-ddd --skill doc-is-ivanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents research, architectural decisions, and task discoveries from getting lost in chat history by turning them into structured documentation inside ProductSpecification/ with clear cross-references.

Core Features & Use Cases

  • Guided documentation workflow: Helps decide what to document, where it should live, and how to name it based on whether the knowledge is task-specific or broadly reusable.
  • Cross-reference management: Identifies related specs, stories, tasks, and other repository documents that should link to the new write-up and be linked from it.
  • Repository-aware knowledge capture: Updates documentation in context, including index files like ProductSpecification/AGENTS.md when a new folder is created.
  • Use Case: After researching an API behavior or resolving an architecture question, use this Skill to create a canonical reference document and connect it to the relevant task specs and product docs.

Quick Start

Ask the doc skill to write up the findings from your current session into a new ProductSpecification document and add the relevant cross-references.

Frequently Asked Questions about doc

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

FAQPage Schema
How do I turn research findings into structured markdown documentation?

To turn research findings into structured markdown documentation, this Skill captures session knowledge and writes it into ProductSpecification files. It determines document placement, proposes filenames, and ensures content is focused and linked.

What is the best way to document architecture notes and API discoveries in a repository?

Documenting architecture notes and API discoveries is best handled by creating canonical reference write-ups inside ProductSpecification. This approach preserves task learnings and story documentation directly in the repository with durable cross-references.

How do I manage bidirectional cross-references between related specs and tasks?

Managing bidirectional cross-references involves scanning related specs and tasks to identify necessary inbound and outbound links. This Skill automatically proposes these connections to keep your repository knowledge linked and navigable.

Can I automatically update index files when creating new documentation folders?

Yes, you can update index files when creating new documentation folders. This repository-aware Skill modifies files like ProductSpecification/AGENTS.md automatically to reflect new directories and maintain accurate knowledge capture.

When do I need to create ProductSpecification markdown files for project knowledge?

You need to create ProductSpecification markdown files when you have reusable task learnings, API discoveries, or architecture decisions that should be preserved. This prevents project knowledge from getting lost in chat history.

Does this documentation workflow require deciding where knowledge should live in the repository?

Yes, the documentation workflow requires deciding where knowledge should live based on whether it is task-specific or broadly reusable. This Skill guides you through document placement and filename selection to organize repository content effectively.