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.