plan-flow

Category: Tools & Productivity | Uploader: brunoscardoso | Downloads: 0 | Version: v1.0（Latest）

Structured AI-assisted development workflows - discovery, planning, execution, code reviews, and testing

Changelog: Source: GitHub https://github.com/brunoscardoso/plan-flow

Directory Structure

Current level: skills/plan-flow/

📁 brain/
- 📄 SKILL.md 2.2 KB
📁 create-contract/
- 📄 SKILL.md 3.1 KB
📁 create-plan/
- 📄 SKILL.md 2.6 KB
📁 discovery/
- 📄 SKILL.md 2.4 KB
📁 execute-plan/
- 📄 SKILL.md 2.7 KB
📁 flow/
- 📄 SKILL.md 2.7 KB
📁 learn/
- 📄 SKILL.md 2.0 KB
📁 ledger/
- 📄 SKILL.md 2.1 KB
📁 review-code/
- 📄 SKILL.md 2.7 KB
📁 review-pr/
- 📄 SKILL.md 2.8 KB
📁 setup/
- 📄 SKILL.md 2.1 KB
📁 write-tests/
- 📄 SKILL.md 2.9 KB
📄 SKILL.md 5.6 KB

SKILL.md

---
name: plan-flow
version: 1.0.8
description: Structured AI-assisted development workflows - discovery, planning, execution, code reviews, and testing
metadata: {"openclaw":{"requires":{"bins":["git","gh"]}},"clawhub":{"requires":{"bins":["git","gh"]},"emoji":"🗺️","homepage":"https://github.com/brunoscardoso/plan-flow"}}
homepage: https://github.com/brunoscardoso/plan-flow
user-invocable: true
---

# Plan-Flow: Structured AI-Assisted Development

A comprehensive skill set for AI-assisted software development with structured workflows and persistent project memory.

## Available Commands

| Command | Description |
|---------|-------------|
| `/setup` | Analyze project and generate pattern files |
| `/discovery` | Create discovery document for requirements gathering |
| `/create-plan` | Create implementation plan with phases and complexity scores |
| `/execute-plan` | Execute plan phases with verification |
| `/create-contract` | Create integration contract from API docs |
| `/review-code` | Review local uncommitted changes |
| `/review-pr` | Review a Pull Request |
| `/write-tests` | Write tests to achieve coverage target |
| `/note` | Manual brain entry (capture meeting notes, ideas, brainstorms) |
| `/learn` | Extract reusable patterns from current session |
| `/flow` | Toggle autopilot mode (auto-chains the full workflow) |

## Always-Active Features

| Feature | Description |
|---------|-------------|
| Project Ledger | Persistent learning journal at `flow/ledger.md` - silently captures mistakes, corrections, and project-specific knowledge across sessions |
| Project Brain | Automatic knowledge capture at `flow/brain/` - records features, errors, decisions, and session logs with Obsidian-compatible `[[wiki-links]]` |
| Project Tasklist | Persistent todo list at `flow/tasklist.md` — **MUST be written to disk**, never kept in-memory only. Every task addition or status change must edit the file immediately. |
| Resource Capture | During any skill execution, watches for valuable reference materials (API specs, architecture notes, domain knowledge) and asks user before saving to `flow/resources/` |

## Recommended Workflow

**Automated - runs without asking permission:**

```
1. /setup           → Index project patterns (run once)
2. /discovery       → Gather requirements for a feature
3. /create-plan     → Create structured implementation plan (auto-runs after discovery)
4. /execute-plan    → Execute the plan phase by phase (auto-runs after plan)
5. /review-code     → Review changes before committing
6. Archive          → Move discovery + plan to flow/archive/
```

**Only stop to ask the user when:**
- Missing critical information (device type, browser, etc.)
- Need to reproduce an issue
- Ambiguous requirements
- Need approval for destructive actions

**Never ask "Ready to create plan?" or "Proceed with execution?" - just do it.**

## Core Concepts

### Complexity Scoring

Every plan phase has a complexity score (0-10):

| Score | Level | Description |
|-------|-------|-------------|
| 0-2 | Trivial | Simple, mechanical changes |
| 3-4 | Low | Straightforward implementation |
| 5-6 | Medium | Moderate complexity, some decisions |
| 7-8 | High | Complex, multiple considerations |
| 9-10 | Very High | Significant complexity/risk |

### Flow Directory Structure

All artifacts are stored in `flow/`:

```
flow/
├── archive/           # Completed/abandoned plans
├── brain/             # Automatic knowledge capture (Obsidian-compatible)
│   ├── index.md       # Brain index (loaded at session start)
│   ├── features/      # Feature history and context
│   ├── errors/        # Reusable error patterns
│   ├── decisions/     # Decision records
│   └── sessions/      # Daily activity logs
├── contracts/         # Integration contracts
├── discovery/         # Discovery documents
├── plans/             # Active implementation plans
├── references/        # Auto-generated reference materials (tech-foundation, business-context)
├── resources/         # Valuable artifacts captured during skill execution
├── reviewed-code/     # Code review documents
├── reviewed-pr/       # PR review documents
├── tasklist.md        # Project todo list (updated in real-time during execution)
├── log.md             # Heartbeat log of important events
└── ledger.md          # Persistent project learning journal
```

## Critical Rules

1. **Automated Workflow**: Run discovery → plan → execute automatically. Only stop to ask when you need information from the user.
2. **Discovery First (Hard Block)**: `/discovery` is **required** before `/create-plan`. Plans cannot be created without a discovery document. No exceptions. If no discovery exists, run discovery first.
3. **Tests Last**: Tests are always the last phase of any implementation plan.
4. **Build at End Only**: Run build verification only after ALL phases complete.
5. **Archive When Done**: Move completed discovery and plans to `flow/archive/`.
6. **Tasklist is a file, not memory**: When adding, moving, or completing tasks, you MUST write changes to `flow/tasklist.md`. NEVER keep tasks only in conversation memory.

## Configuration

Create `.plan-flow.yml` in your project root:

```yaml
ai:
  provider: claude
  anthropic_api_key: sk-ant-api03-your-key-here
```

## Requirements

- `git` - For version control operations
- `gh` - GitHub CLI for PR reviews

## Installation

```bash
clawhub install plan-flow
```

Or add to your workspace skills folder:

```bash
git clone https://github.com/brunoscardoso/plan-flow.git ~/.openclaw/skills/plan-flow
```

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

plan-flow

Directory Structure

SKILL.md

Report

Notice