docs-first

Draft and refresh PRD, TECH_SPEC, and ACTION_PLAN artifacts before implementation.

3|1|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/Kbediako/CO --skill docs-first
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-first
Source: https://github.com/Kbediako/CO/tree/main/skills/docs-first
Command: npx skills add https://github.com/Kbediako/CO --skill docs-first

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the creation and maintenance of spec-driven work artifacts (PRD, TECH_SPEC, ACTION_PLAN) and their linkage to task registries, ensuring alignment before implementation.

Core Features & Use Cases

  • Draft/refresh PRD (intent and translation of user request) using templates.
  • Generate TECH_SPEC using templates and store under tasks/specs.
  • Create/refresh the task checklist and mirror to .agent/task/, update docs/TASKS.md.
  • Link TECH_SPEC in tasks/index.json and maintain machine-readable artifacts.

Quick Start

Use this skill to draft or refresh PRD, TECH_SPEC, and ACTION_PLAN for a new task, then register and harvest checklists for review before coding.

Frequently Asked Questions about docs-first

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

FAQPage Schema
How do I generate a PRD and TECH_SPEC before coding?

You generate a PRD and TECH_SPEC before coding by using templates to draft or refresh product requirements and technical specifications, capturing user intent and linking them directly to task registries for alignment.

What is the best way to link a TECH_SPEC to a task registry?

The best way to link a TECH_SPEC to a task registry is to generate the spec under tasks/specs, register it in tasks/index.json, and mirror the checklist to .agent/task/ to maintain machine-readable artifacts.

How does a docs-review step work in spec-driven planning?

A docs-review step in spec-driven planning works by harvesting the generated ACTION_PLAN and task checklists to validate requirements and document reviews before any implementation execution begins.

Do I need to update docs/TASKS.md manually when creating an ACTION_PLAN?

You do not need to update docs/TASKS.md manually when creating an ACTION_PLAN, because the process automatically creates and refreshes the task checklist while mirroring updates directly to the task index.

Can I use templates to refresh an existing PRD for a new task?

You can use templates to refresh an existing PRD for a new task by re-evaluating the user request translation, updating the intent, and regenerating the linked specifications and action plans.

When do I need spec-driven artifacts in product development?

You need spec-driven artifacts in product development when workflows require strict alignment, meaning specifications must be drafted, linked to tasks, and reviewed before implementation begins.