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.