planflow-ai 1.1.3 → 1.1.5

package/.claude/commands/brain.md

@@ -48,12 +48,13 @@ MODES:
   Guided:     Asks structured questions about work, insights, meetings, decisions
 
 BRAIN STRUCTURE:
-  flow/brain/
-  ├── index.md        # Brain index (always loaded at session start)
-  ├── features/       # Feature history and context
-  ├── errors/         # Reusable error patterns
-  ├── decisions/      # Decision records
-  └── sessions/       # Daily activity logs
+  flow/brain/                          # Per-project brain
+  ├── index.md                         # Brain index (loaded at session start)
+  ├── features/                        # Feature history and context
+  └── errors/                          # Reusable error patterns
+
+  ~/plan-flow/brain/daily/             # Global daily logs (cross-project)
+  └── YYYY-MM-DD.md
 
 RELATED COMMANDS:
   /setup             Creates brain directory structure
@@ -63,16 +64,13 @@ RELATED COMMANDS:
 
 ---
 
-> **AGENT_PROFILE: write-restricted**
-> See `.claude/resources/core/agent-profiles.md` for tool access rules.
-
 ## Critical Rules
 
 | Rule                     | Description                                              |
 | ------------------------ | -------------------------------------------------------- |
 | **Brain Only**           | ONLY write to `flow/brain/` - no source code, no config  |
 | **Wiki-Links**           | All cross-references use `[[kebab-case-name]]` format    |
-| **Index Caps**           | Max 5 errors, 3 decisions, 3 cross-project in index      |
+| **Index Caps**           | Max 5 errors, 3 cross-project in index                    |
 | **No Code**              | Brain is for knowledge capture, never write source code   |
 | **Complete and Stop**    | After writing entry, STOP and wait for user               |
 
@@ -102,7 +100,7 @@ What would you like to capture? You can:
 Check if `flow/brain/` exists. If not, create:
 
 ```bash
-mkdir -p flow/brain/features flow/brain/errors flow/brain/decisions flow/brain/sessions
+mkdir -p flow/brain/features flow/brain/errors
 ```
 
 Check if `flow/brain/index.md` exists. If not, create initial index:
@@ -116,9 +114,6 @@ _No features tracked yet._
 ## Recent Errors
 _No errors captured yet._
 
-## Recent Decisions
-_No decisions recorded yet._
-
 ## Cross-Project Patterns
 _No cross-project patterns yet._
 ```

package/.claude/commands/create-contract.md

@@ -55,18 +55,12 @@ RELATED COMMANDS:
 
 ---
 
-> **MODE: Research**
-> Explore before concluding. Read 3x more than you write. Prefer Read/Grep/Glob/WebSearch tools.
-> Ask clarifying questions when uncertain. Don't jump to implementation.
-
-> **AGENT_PROFILE: read-only**
-> See `.claude/resources/core/agent-profiles.md` for tool access rules.
-
 ## Critical Rules
 
 | Rule                     | Description                                              |
 | ------------------------ | -------------------------------------------------------- |
 | **No Auto-Chaining**     | NEVER auto-invoke /discovery-plan - user must invoke it  |
+| **File Only**            | Save the `.md` file and report its path. Do NOT show full content in chat. |
 | **Complete and Stop**    | After presenting results, STOP and wait for user         |
 
 ---
@@ -122,27 +116,30 @@ See: `.claude/resources/skills/create-contract-skill.md`
 
 ---
 
-### Step 4: Present Results
+### Step 4: Save File and Stop
 
-After the skill completes, confirm file creation:
+After the skill completes:
 
-```markdown
-Contract Created!
+1. **Save the contract document** to `flow/contracts/<service_name>_contract.md`
+2. **Report only the file path** — do NOT display the full contract content in chat
+3. **STOP** — do NOT auto-invoke `/discovery-plan`
 
-**Deliverable**: `flow/contracts/<service_name>_contract.md`
+**Output to the user** (this is the ONLY thing to show):
 
-**Summary**:
-- X endpoints documented
-- Authentication: [method]
-- Error handling documented
+```markdown
+Contract created.
 
-**Next Steps** (user must invoke manually):
-1. Review the contract above
-2. Request any refinements
-3. When ready, invoke `/discovery-plan @flow/contracts/<service_name>_contract.md`
+**Created**: `flow/contracts/<service_name>_contract.md`
+
+Next: review the file, then run `/discovery-plan` when ready.
 ```
 
-**CRITICAL**: This command is now complete. Do NOT auto-invoke `/discovery-plan`. Wait for the user to explicitly invoke it.
+⚠️ **CRITICAL**: After saving the file, the command is DONE. Do NOT:
+- Show the full contract content in chat
+- Auto-invoke `/discovery-plan`
+- Offer to start discovery or planning
+
+The user will read the `.md` file themselves and decide when to proceed.
 
 ---
 
@@ -175,9 +172,10 @@ Contract Created!
                     |
                     v
 +------------------------------------------+
-| Step 4: Present Results                  |
-| - Show summary                           |
-| - Link to /discovery-plan command        |
+| Step 4: Save File and Stop               |
+| - Save .md file to flow/contracts/       |
+| - Report file path only                  |
+| - STOP (no discovery, no plan)           |
 +------------------------------------------+
 ```
 
@@ -248,47 +246,3 @@ When executing this command:
 | `interactive-questions-tool.md` | Interactive Questions UI workflow    |
 | `/discovery-plan` command      | Create discovery from contract         |
 | `/create-plan` command         | Create plan from discovery             |
-
----
-
-## Compaction Suggestion
-
-After contract creation completes, suggest context cleanup if the contract was complex (> 5 endpoints):
-
-> Contract created. Consider running `/compact` to free context before the next task.
-
-Skip if autopilot is ON.
-
----
-
-## Brain Capture
-
-After contract creation completes, append a brain-capture block. See `.claude/resources/core/brain-capture.md` for processing rules.
-
-**Capture the following**:
-
-```
-<!-- brain-capture
-skill: create-contract
-feature: [service name]
-status: completed
-data:
-  service_name: [API/service name]
-  endpoints_documented: [count]
-  auth_type: [detected auth type]
-  contract_doc: [path to contract document]
--->
-```
-
-Update `flow/brain/features/[service-name].md` with contract context and update `flow/brain/index.md`.
-
----
-
-## Resource Capture
-
-During this skill's execution, watch for valuable reference materials worth preserving. See `.claude/resources/core/resource-capture.md` for capture rules, file format, and naming conventions.
-
-At natural break points, if you encounter information that could be useful for future development (API specs, architecture notes, config references, domain knowledge, etc.), ask the user: "I found something that could be useful for future reference: _{brief description}_. Should I save it to `flow/resources/`?"
-
-Only save if the user approves. Do not re-ask if declined.
-

package/.claude/commands/create-plan.md

@@ -25,25 +25,18 @@ DESCRIPTION:
   and tasks based on a discovery document or user input.
 
 USAGE:
-  /create-plan [flags] <discovery_document>
-  /create-plan [flags] <feature_description>
+  /create-plan <discovery_document>
+  /create-plan <feature_description>
   /create-plan -help
 
 ARGUMENTS:
   discovery_document   Path to discovery document (recommended)
   feature_description  Direct description of feature to plan (if no discovery)
 
-WORKFLOW FLAGS (optional):
-  -bugfix    Skip the discovery gate requirement. The bug report and user
-             description serve as plan input instead of a discovery document.
-             Use when fixing a bug where formal discovery is unnecessary.
-
-  Without a flag, a discovery document is required (standard behavior).
-
 EXAMPLES:
   /create-plan @flow/discovery/discovery_user_auth_v1.md
   /create-plan "Add dark mode toggle to settings page"
-  /create-plan -bugfix "Fix login timeout after 30 seconds of inactivity"
+  /create-plan @flow/contracts/api_contract.md
 
 OUTPUT:
   Creates: flow/plans/plan_<feature_name>_v<version>.md
@@ -71,43 +64,19 @@ RELATED COMMANDS:
 > - **If YES**: Autopilot is ON. After creating the plan and getting user approval, **auto-proceed** to `/execute-plan` with the plan output. Do NOT wait for manual invocation.
 > - **If NO**: Follow the standard rules below (stop and wait for user).
 
-> **MODE: Research**
-> Explore before concluding. Read 3x more than you write. Prefer Read/Grep/Glob/WebSearch tools.
-> Ask clarifying questions when uncertain. Don't jump to implementation.
-
-> **AGENT_PROFILE: read-only**
-> See `.claude/resources/core/agent-profiles.md` for tool access rules.
-
 ## Critical Rules
 
 | Rule                     | Description                                              |
 | ------------------------ | -------------------------------------------------------- |
-| **Discovery Required**   | NEVER create a plan without a discovery document. If none exists, run `/discovery-plan` first. **Exception**: The `-bugfix` flag bypasses this requirement — the bug report serves as input. |
+| **Discovery Required**   | NEVER create a plan without a discovery document. If none exists, run `/discovery-plan` first. No exceptions. |
 | **No Auto-Chaining**     | NEVER auto-invoke /execute-plan - user must invoke it (unless autopilot ON) |
+| **File Only**            | Save the `.md` file and report its path. Do NOT show full content in chat. |
 | **Complete and Stop**    | After presenting results, STOP and wait for user (unless autopilot ON) |
 
 ---
 
 ## Instructions
 
-### Step 0: Parse Workflow Flag
-
-Check if the user input starts with a workflow flag:
-
-| Flag | Behavior Change |
-|------|----------------|
-| `-bugfix` | **Skip the discovery gate** (Step 2). The user's bug description + any diagnostic review serve as plan input. No discovery document required. The plan should focus on: root cause fix, regression prevention, and verification steps. |
-| (none) | Standard behavior — discovery document required |
-
-If a flag is found:
-1. Set the **workflow context** for this execution
-2. Remove the flag from the input (the rest is the user's prompt/reference)
-3. The `-bugfix` flag bypasses the discovery gate in Step 2
-
-If no flag is found: proceed with standard behavior (backward compatible).
-
----
-
 ### Step 1: Validate Inputs
 
 | Input                | Required | Description                                        |
@@ -119,13 +88,9 @@ If no flag is found: proceed with standard behavior (backward compatible).
 
 ---
 
-### Step 2: Validate Discovery Phase Completion (CONDITIONAL BLOCK)
-
-**A discovery document is REQUIRED before creating any plan — unless the `-bugfix` flag is set.**
-
-**If `-bugfix` flag is present**: Skip this step entirely. The user's bug description and any diagnostic review findings serve as plan input. Proceed directly to Step 3.
+### Step 2: Validate Discovery Phase Completion (HARD BLOCK)
 
-**If no `-bugfix` flag**:
+**A discovery document is REQUIRED before creating any plan. No exceptions.**
 
 1. Check user input for a discovery document reference (`@flow/discovery/...`)
 2. If no reference provided, search `flow/discovery/` for a matching discovery document
@@ -143,6 +108,7 @@ If no flag is found: proceed with standard behavior (backward compatible).
 4. If a discovery document IS found: Proceed with plan creation using that document
 
 **Important**: NEVER read or reference files in `flow/archive/` - these are outdated.
+**Important**: NEVER create a plan without a discovery document. This rule has NO exceptions.
 
 ---
 
@@ -169,50 +135,31 @@ See: `.claude/resources/skills/create-plan-skill.md`
 
 ---
 
-### Step 5: Present Results
+### Step 5: Save File and Stop
 
-After the skill completes, confirm file creation and summarize:
+After the skill completes:
 
-```markdown
-Plan Created!
+1. **Save the plan document** to `flow/plans/plan_<feature>_v<version>.md`
+2. **Report only the file path** — do NOT display the full plan content in chat
+3. **STOP** — do NOT execute the plan, do NOT offer to build
 
-**Deliverable**: `flow/plans/plan_<feature>_v<version>.md`
+**Output to the user** (this is the ONLY thing to show):
 
-**Summary**:
-- X phases created
-- Total complexity: XX/XX
-- Highest complexity: Phase X at Y/10
-```
+```markdown
+Plan created.
 
-**CRITICAL — Check autopilot mode BEFORE presenting next steps:**
-
-1. **Check if `flow/.autopilot` exists**
-2. **If autopilot is ON**: Do NOT show "Next Steps" or "invoke manually". Instead, use `AskUserQuestion` to ask for plan approval, then **immediately auto-proceed** to `/execute-plan` with the plan file. Do NOT stop. Do NOT wait for the user to manually invoke `/execute-plan`.
-
-```typescript
-// When autopilot is ON, ask for approval then auto-proceed:
-AskUserQuestion({
-  questions: [{
-    question: "Plan is ready. Approve to proceed with execution?",
-    header: "Plan",
-    options: [
-      { label: "Approve and execute", description: "Start executing the plan now" },
-      { label: "Refine first", description: "Let me suggest changes to the plan before executing" }
-    ],
-    multiSelect: false
-  }]
-})
-// If approved → immediately invoke /execute-plan (do NOT stop)
+**Created**: `flow/plans/plan_<feature>_v<version>.md`
+
+Next: review the file, then run `/execute-plan` when ready.
 ```
 
-3. **If autopilot is OFF**: Show next steps and stop:
+⚠️ **CRITICAL**: After saving the file, the command is DONE. Do NOT:
+- Show the full plan content in chat
+- Auto-invoke `/execute-plan`
+- Offer to start building or implementing
+- Show implementation steps or code
 
-```markdown
-**Next Steps**:
-1. Review the plan above
-2. Request any refinements
-3. When ready, invoke `/execute-plan @flow/plans/plan_<feature>_v<version>.md`
-```
+The user will read the `.md` file themselves and decide when to proceed.
 
 ---
 
@@ -252,9 +199,10 @@ AskUserQuestion({
                     |
                     v
 +------------------------------------------+
-| Step 5: Present Results                  |
-| - Show summary                           |
-| - Link to /execute-plan command          |
+| Step 5: Save File and Stop               |
+| - Save .md file to flow/plans/           |
+| - Report file path only                  |
+| - STOP (no execute, no build)            |
 +------------------------------------------+
 ```
 
@@ -327,63 +275,3 @@ When executing this command:
 | `complexity-scoring.md`    | Complexity scoring system         |
 | `/discovery-plan` command   | Run discovery first               |
 | `/execute-plan` command     | Execute the created plan          |
-
----
-
-## Compaction Suggestion
-
-After plan creation completes, suggest context cleanup:
-
-> Plan created. Consider running `/compact` before execution to maximize available context for the implementation phases.
-
-Only suggest if the plan has > 3 phases. Skip if autopilot is ON.
-
----
-
-## Brain Capture
-
-After plan creation completes successfully, append a brain-capture block. See `.claude/resources/core/brain-capture.md` for processing rules.
-
-**Capture the following**:
-
-```
-<!-- brain-capture
-skill: create-plan
-feature: [feature name]
-status: completed
-data:
-  phase_count: [number of phases]
-  total_complexity: [sum of complexity scores]
-  highest_phase: [phase name with highest score]
-  discovery_link: [[discovery-feature-name]]
-  plan_doc: [path to plan document]
--->
-```
-
-Update `flow/brain/features/[feature-name].md` with plan details and link to discovery entry.
-
----
-
-## Resource Capture
-
-During this skill's execution, watch for valuable reference materials worth preserving. See `.claude/resources/core/resource-capture.md` for capture rules, file format, and naming conventions.
-
-At natural break points, if you encounter information that could be useful for future development (API specs, architecture notes, config references, domain knowledge, etc.), ask the user: "I found something that could be useful for future reference: _{brief description}_. Should I save it to `flow/resources/`?"
-
-Only save if the user approves. Do not re-ask if declined.
-
----
-
-## Handoff
-
-### Consumption
-
-Before creating the plan, check for `flow/handoffs/handoff_<feature>_discovery_to_plan.md` (or `handoff_<feature>_review_to_plan.md` for bugfix workflow). If it exists, read it silently and use its focus guidance to inform plan structure. If it doesn't exist, proceed normally (backward compatible).
-
-### Production
-
-After the plan is created, produce a handoff for the execution step.
-
-**Output**: `flow/handoffs/handoff_<feature>_plan_to_execute.md`
-
-Include: feature name, workflow type, phase count, total complexity, highest complexity phase, plan and discovery paths, and focus guidance for execution.