plan-doc

Plan and document DataSpoke features within the spec/ hierarchy.

15|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/selhorys/dataspoke-baseline --skill plan-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-doc
Source: https://github.com/selhorys/dataspoke-baseline/tree/main/.claude/skills/plan-doc
Command: npx skills add https://github.com/selhorys/dataspoke-baseline --skill plan-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write specification or planning documents for DataSpoke features, components, and architectural decisions in the spec/ hierarchy, ensuring consistent structure and alignment with the MANIFESTO and ARCHITECTURE guidelines.

Core Features & Use Cases

  • Provides a timeless template for feature and spoke documentation, including the required Section headers and routing rules to place documents under spec/feature or spec/feature/spoke.
  • Enables teams to plan, spec, and document changes (architecture decisions, feature designs, and implementation plans) in a single, standardized location.
  • Guides authors through a step-by-step process: read context, determine destination, write the document, and update cross-references to reflect architecture relationships.

Quick Start

Create a new spec/feature/spoke/<FEATURE>.md using the template in spec/ and start with a concise overview of goals.

Frequently Asked Questions about plan-doc

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

FAQPage Schema
How do I standardize feature specification documentation in a spec hierarchy?

Standardize feature specification documentation by applying a frontmatter-driven schema and required section headers like 'What problem does it solve?' within the spec/ directory. This ensures architectural alignment and consistent document placement.

What is the correct way to route planning documents for new features under spec directories?

Route planning documents by determining the correct destination folder, placing feature designs under spec/feature or spec/feature/spoke. This enforces structural governance and maintains accurate cross-references for architectural relationships.

How do I write a DataSpoke feature plan that aligns with architecture guidelines?

Write a DataSpoke feature plan by reading context, determining the destination folder, writing the document using a timeless template, and updating cross-references. This ensures alignment with MANIFESTO and ARCHITECTURE guidelines.

What sections are required when documenting architecture decisions for DataSpoke components?

Required sections for documenting architecture decisions include 'What problem does it solve?', 'Core Features & Use Cases', and 'Quick Start'. This frontmatter-driven schema provides a consistent layout for feature and spoke documentation.

Do I need specific dependencies to create standardized templates for feature documentation?

No specific external dependencies are required to create standardized templates for feature documentation. The process relies solely on organizing content within the spec/ hierarchy using a structured, frontmatter-driven schema.

Why does my new planning document lack cross-references to existing architecture relationships?

Planning documents lack cross-references when the final step of updating architecture relationships is skipped. After writing the document under spec/feature or spec/feature/spoke, you must manually update cross-references to reflect dependencies.