Why does this skill prevent immediate code editing?

It acts as a guardrail to ensure that Claude describes its intended logic in a PLAN.md file first, reducing the risk of errors during complex tasks.

Can I use this for collaborative coding?

Yes, by committing the generated plans to your repository, team members can review the AI's intended logic before the code is actually changed.

What files are required to initiate a plan?

The skill reads from WORK_ORDER, PLAN_QUEUE, or POINTER files to understand the context of the task at hand.

Where are the implementation plans stored?

All plans are saved within the project root under a 'plans/' directory, organized by specific plan IDs.

How does it track the progress of a plan?

It uses a STATUS.json file within each plan directory to record the current state and completion status of the proposed changes.

Plan-First Development Workflow

Name: Plan-First Development Workflow
Author: ling5477

byling5477

0•

Productividad y Flujo de Trabajo

Enforces a strict documentation-first architecture by requiring all implementation details to be saved to disk before code modifications begin.

The Plan-First skill implements a disciplined development methodology for Claude Code by mandating a formal planning phase prior to any source code execution. By integrating with task queues and work orders, it ensures that every proposed change is backed by a structured PLAN.md file and tracked via a STATUS.json file within a dedicated directory. This prevents impulsive or undocumented code changes, improves project traceability, and helps maintain a clear record of the AI's decision-making process, making it ideal for complex refactoring and collaborative environments.

Características Principales

01Strict enforcement of 'plan before code' policy

02Prevents unauthorized code modifications without an archived plan

03Seamless integration with WORK_ORDER and PLAN_QUEUE systems

040 GitHub stars

05Automated creation of PLAN.md and STATUS.json for task tracking

06Persistent storage of implementation logic in a dedicated plans/ directory

Casos de Uso

01Managing large-scale refactors where step-by-step documentation is critical

02Organizing complex task queues into a structured implementation pipeline

03Maintaining an audit trail of AI-driven architectural decisions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ling5477/decision-hub 01_plan_first

For use in Claude.ai and ChatGPT

Download Skill