requirement-to-plan

Convert natural-language requirements into docs/ plan files with lifecycle commits.

4|Updated Aug 25, 2024
One-click install
npx skills add https://github.com/chnots/chnots --skill requirement-to-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirement-to-plan
Source: https://github.com/chnots/chnots/tree/main/.opencode/skills/requirement-to-plan
Command: npx skills add https://github.com/chnots/chnots --skill requirement-to-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert natural-language requirements into concrete, executable task plans and lifecycle commits within a repository. It helps teams translate vague requests into structured docs under docs/ and manage task workflows with branch and commit conventions.

Core Features & Use Cases

  • Convert user requests into a docs/ yymm-dd-task-desc.md plan file.
  • Extract inputs such as Goal, Scope, Constraints, Acceptance criteria, and a short task slug from user prompts.
  • Enforce naming and workflow: create a feat/yymm-dd-task-desc branch, start with a task-start commit, and finish by moving to docs/done with a task-done commit.
  • Provide a repeatable, auditable planning process integrated with docs and version control.

Quick Start

Provide a clear requirement and the skill will generate a docs/ plan file named yymm-dd-task-desc.md and start the task workflow with a task-start commit.

Frequently Asked Questions about requirement-to-plan

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

FAQPage Schema
How do I convert natural-language requirements into executable task plans?▼

To convert natural-language requirements into executable task plans, you provide a clear text prompt containing the goal, scope, and constraints. The system then generates a structured plan file and initiates the task workflow automatically.

How does the task planning workflow integrate with git branching and commits?▼

The task planning workflow integrates with git by creating a dedicated feature branch named using the yymm-dd-task-desc format. It initiates work with a task-start commit and finalizes it by moving the plan to docs/done with a task-done commit.

What is the required file naming convention for project planning documents?▼

The required file naming convention for project planning documents is yymm-dd-task-desc.md. Files must be created under the docs/ directory and moved to docs/done upon task completion to maintain an auditable repository structure.

Can I automate task lifecycle commits for project planning in docs?▼

Yes, you can automate task lifecycle commits for project planning in docs. The process enforces branch creation and generates task-start and task-done commits to ensure a repeatable and auditable version control history.

What inputs do I need to provide to generate a project plan file?▼

To generate a project plan file, you need to provide inputs such as the project Goal, Scope, Constraints, Acceptance criteria, and a short task slug extracted from your natural-language prompt.

What is the best way to structure vague feature requests for version control?▼

The best way to structure vague feature requests for version control is to translate them into concrete markdown plans under docs/ using a standardized naming format. This approach pairs planning documents directly with lifecycle branching and commits.