planflow-ai 1.4.1 → 1.4.3

package/.claude/resources/core/_index.md

@@ -1,347 +0,0 @@
-
-# Core Rules Index
-
-## Overview
-
-Core rules define the foundational coding standards that apply across the entire project. These include best practices to follow (allowed patterns), anti-patterns to avoid (forbidden patterns), and complexity scoring for implementation planning.
-
-**Total Files**: 25 files, ~5550 lines
-**Reference Codes**: COR-AP-1 through COR-AC-3
-
----
-
-## Reference Codes
-
-### Allowed Patterns (`allowed-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-AP-1 | Example patterns (Naming, SRP, Errors, Types, Organization) | allowed-patterns.md | 45-152 |
-| COR-AP-2 | Template for adding new patterns | allowed-patterns.md | 167-186 |
-
-### Forbidden Patterns (`forbidden-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-FP-1 | Example anti-patterns (Magic Numbers, Silent Errors, Ternaries, Mutation, Async) | forbidden-patterns.md | 41-230 |
-| COR-FP-2 | Template for adding new anti-patterns | forbidden-patterns.md | 245-264 |
-
-### Complexity Scoring (`complexity-scoring.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-CS-1 | Complexity scale table (0-10 levels) | complexity-scoring.md | 12-21 |
-| COR-CS-2 | Scoring criteria modifiers (+/- points) | complexity-scoring.md | 23-51 |
-| COR-CS-3 | Execution strategy and aggregation rules | complexity-scoring.md | 53-70 |
-| COR-CS-4 | Common complexity patterns table | complexity-scoring.md | 168-185 |
-| COR-CS-5 | Real-world scoring examples | complexity-scoring.md | 187-236 |
-
-### Autopilot Mode (`autopilot-mode.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-AM-1 | Input classification (slash commands, questions, trivial, feature requests) | autopilot-mode.md | 18-50 |
-| COR-AM-2 | Flow execution steps (contracts, discovery, plan, execute, review, archive) | autopilot-mode.md | 52-110 |
-| COR-AM-3 | Mandatory checkpoints and overriding rules | autopilot-mode.md | 140-178 |
-
-### Project Ledger (`project-ledger.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-LDG-1 | Ledger behavior, entry format, and sections | project-ledger.md | 10-110 |
-| COR-LDG-2 | Maintenance rules and plan-flow integration | project-ledger.md | 112-155 |
-
-### Brain Capture (`brain-capture.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-BR-1 | Session start behavior and brain-capture processing rules | brain-capture.md | 10-50 |
-| COR-BR-2 | File templates (feature, error, decision, session) and naming conventions | brain-capture.md | 52-170 |
-| COR-BR-3 | Index management (caps, rotation) and global brain sync | brain-capture.md | 172-240 |
-
-### Project Memory (`project-memory.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-MEM-1 | Memory session start behavior and entry format | project-memory.md | 10-50 |
-| COR-MEM-2 | Field descriptions and maintenance rules | project-memory.md | 52-75 |
-
-### Project Tasklist (`project-tasklist.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-TL-1 | Tasklist session start behavior and task format | project-tasklist.md | 10-45 |
-| COR-TL-2 | Brain integration and maintenance rules | project-tasklist.md | 47-65 |
-
-### Heartbeat (`heartbeat.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-HB-1 | Heartbeat file format and schedule syntax | heartbeat.md | 10-55 |
-| COR-HB-2 | Daemon architecture, CLI commands, and rules | heartbeat.md | 57-110 |
-
-### Resource Capture (`resource-capture.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-RC-1 | Capture behavior, criteria, and what NOT to capture | resource-capture.md | 10-60 |
-| COR-RC-2 | File format, naming conventions, and rules | resource-capture.md | 62-110 |
-
-### Learn Recommendations (`learn-recommendations.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-LR-1 | Trigger conditions and detection logic | learn-recommendations.md | 10-62 |
-| COR-LR-2 | Recommendation format, rules, and integration points | learn-recommendations.md | 64-170 |
-
-### Pattern Capture (`pattern-capture.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-PC-1 | Capture behavior, triggers, and buffer format | pattern-capture.md | 10-80 |
-| COR-PC-2 | End-of-skill review protocol and user approval flow | pattern-capture.md | 82-140 |
-| COR-PC-3 | Auto-captured entry format and conflict detection | pattern-capture.md | 142-210 |
-
-### Model Routing (`model-routing.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-MR-1 | Model tiers, platform mappings, and routing rules | model-routing.md | 10-60 |
-| COR-MR-2 | Aggregation behavior and plan mode exception | model-routing.md | 62-85 |
-| COR-MR-3 | Cost impact estimates and execution summary format | model-routing.md | 87-115 |
-
-### Design Awareness (`design-awareness.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-DA-1 | Design Context template and personalities | design-awareness.md | 14-180 |
-| COR-DA-2 | Token extraction and UI detection rules | design-awareness.md | 182-260 |
-| COR-DA-3 | Discovery question flow and execution injection | design-awareness.md | 262-350 |
-
-### Review Verification (`review-verification.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-RV-1 | Verification logic, questions, and classification criteria | review-verification.md | 1-120 |
-| COR-RV-2 | Output format and insertion points | review-verification.md | 122-200 |
-
-### Review Multi-Agent (`review-multi-agent.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-MA-1 | Subagent definitions (security, logic, performance, patterns) with prompts and models | review-multi-agent.md | 30-130 |
-| COR-MA-2 | Coordinator behavior (spawn, collect, deduplicate, verify, rank, output) | review-multi-agent.md | 132-195 |
-| COR-MA-3 | Subagent input rules and diff splitting for very large changesets | review-multi-agent.md | 100-130 |
-| COR-MA-4 | Insertion points for review-code and review-pr skills | review-multi-agent.md | 197-220 |
-
-### Review Severity Re-Ranking (`review-severity-ranking.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-SR-1 | Ranking algorithm (severity → confidence → complexity) | review-severity-ranking.md | 14-26 |
-| COR-SR-2 | Grouping related findings (patterns, rules, format) | review-severity-ranking.md | 28-88 |
-| COR-SR-3 | Executive summary trigger and risk level derivation | review-severity-ranking.md | 90-120 |
-| COR-SR-4 | Output structure and insertion points | review-severity-ranking.md | 122-150 |
-
-### Compaction Guide (`compaction-guide.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-CG-1 | Purpose, core principle, and when to compact | compaction-guide.md | 3-20 |
-| COR-CG-2 | Preserve rules — what to keep during compaction | compaction-guide.md | 22-38 |
-| COR-CG-3 | Discard rules — what to drop during compaction | compaction-guide.md | 40-55 |
-| COR-CG-4 | Compact summary template and skill-specific examples | compaction-guide.md | 57-110 |
-
-### Session Scratchpad (`session-scratchpad.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-SS-1 | Purpose, session start behavior, and write triggers | session-scratchpad.md | 3-45 |
-| COR-SS-2 | File format and 50-line limit | session-scratchpad.md | 47-68 |
-| COR-SS-3 | Promotion rules, targets, and compaction integration | session-scratchpad.md | 70-95 |
-
-### Phase Isolation (`phase-isolation.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-PI-1 | Purpose, architecture overview, and coordinator flow | phase-isolation.md | 3-40 |
-| COR-PI-2 | Context template — what to include in sub-agent prompt | phase-isolation.md | 42-85 |
-| COR-PI-3 | Return format schema (JSON), field descriptions, failure example | phase-isolation.md | 87-140 |
-| COR-PI-4 | Coordinator processing (success/failure/partial), config, and rules | phase-isolation.md | 142-180 |
-
-### Discovery Sub-Agents (`discovery-sub-agents.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-DSA-1 | Agent definitions with prompt templates (Similar Features, API/Data, Schema/Types) | discovery-sub-agents.md | 30-130 |
-| COR-DSA-2 | Return format schema and Codebase Analysis section template | discovery-sub-agents.md | 132-190 |
-| COR-DSA-3 | Coordinator behavior (spawn, collect, merge, error handling) | discovery-sub-agents.md | 192-240 |
-
-### Wave Execution (`wave-execution.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|---------|
-| COR-WAVE-1 | Architecture, dependency analysis rules, and declaration syntax | wave-execution.md | 14-80 |
-| COR-WAVE-2 | Wave grouping algorithm (topological sort, backward compatibility, example) | wave-execution.md | 82-140 |
-| COR-WAVE-3 | Parallel spawning rules and wave execution summary format | wave-execution.md | 142-195 |
-| COR-WAVE-4 | Wave coordinator behavior (per-wave processing, file conflict detection, failure handling, git commit ordering) | wave-execution.md | 197-270 |
-| COR-WAVE-5 | Configuration (flowconfig, interaction matrix, aggregation, rules) | wave-execution.md | 272-340 |
-
-### Review Adaptive Depth (`review-adaptive-depth.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-AD-1 | Size detection, line counting rules, and tier definitions | review-adaptive-depth.md | 14-47 |
-| COR-AD-2 | Lightweight review mode (< 50 lines) — checks, skips, output | review-adaptive-depth.md | 51-101 |
-| COR-AD-3 | Deep review mode (500+ lines) — categorization, passes, executive summary | review-adaptive-depth.md | 103-187 |
-| COR-AD-4 | Insertion points for review-code and review-pr skills | review-adaptive-depth.md | 189-205 |
-
-### Per-Task Verification (`per-task-verification.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-PTV-1 | Purpose, architecture, and verify-diagnose-repair loop flow | per-task-verification.md | 3-40 |
-| COR-PTV-2 | Verify tag syntax, parsing rules, and debug sub-agent prompt/schema | per-task-verification.md | 42-130 |
-| COR-PTV-3 | Verification loop, retry behavior, and task_verifications return field | per-task-verification.md | 132-200 |
-| COR-PTV-4 | Configuration, error handling, wave mode interaction, and rules | per-task-verification.md | 202-260 |
-
-### Atomic Commits (`atomic-commits.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| COR-AC-1 | Purpose, commit format, and sequential mode behavior | atomic-commits.md | 3-80 |
-| COR-AC-2 | Wave mode behavior, JSON schema extension, and coordinator processing | atomic-commits.md | 82-210 |
-| COR-AC-3 | Interaction with phase isolation, wave execution, verification, and configuration | atomic-commits.md | 212-300 |
-
----
----
-
-## When to Expand
-
-| Code | Expand When |
-|------|-------------|
-| COR-AP-1 | Need to see example good patterns for code generation |
-| COR-AP-2 | Adding a new allowed pattern to the project |
-| COR-FP-1 | Need to see anti-patterns to avoid |
-| COR-FP-2 | Adding a new forbidden pattern to the project |
-| COR-CS-1 | Need complexity level definitions |
-| COR-CS-2 | Calculating complexity score for a phase |
-| COR-CS-3 | Determining execution strategy for plan phases |
-| COR-CS-4 | Quick lookup of typical complexity scores |
-| COR-CS-5 | Need detailed scoring examples |
-| COR-LDG-1 | Need ledger behavior and entry guidelines |
-| COR-LDG-2 | Need ledger maintenance and integration rules |
-| COR-AM-1 | Need to understand input classification for autopilot |
-| COR-AM-2 | Need autopilot flow execution steps |
-| COR-AM-3 | Need mandatory checkpoint and override rules |
-| COR-BR-1 | Need brain session start behavior and processing rules |
-| COR-BR-2 | Need brain file templates and naming conventions |
-| COR-BR-3 | Need index management caps and global sync rules |
-| COR-MEM-1 | Need memory session start behavior and entry format |
-| COR-MEM-2 | Need memory field descriptions and maintenance rules |
-| COR-TL-1 | Need tasklist session start behavior and task format |
-| COR-TL-2 | Need tasklist brain integration and maintenance rules |
-| COR-HB-1 | Need heartbeat file format and schedule syntax |
-| COR-HB-2 | Need daemon architecture and CLI commands |
-| COR-RC-1 | Need resource capture behavior and criteria |
-| COR-RC-2 | Need resource file format and naming conventions |
-| COR-LR-1 | Need learn recommendation trigger conditions |
-| COR-LR-2 | Need learn recommendation format and integration rules |
-| COR-PC-1 | Need pattern capture behavior and buffer format |
-| COR-PC-2 | Need end-of-skill review protocol |
-| COR-PC-3 | Need auto-captured entry format and conflict detection |
-| COR-MR-1 | Need model tier definitions and platform mappings |
-| COR-MR-2 | Need aggregation behavior for model routing |
-| COR-MR-3 | Need cost impact estimates or execution summary format |
-| COR-DA-1 | Need design context template or personality options |
-| COR-DA-2 | Need token extraction or UI detection heuristics |
-| COR-DA-3 | Need design question flow or execution injection rules |
-| COR-RV-1 | Need verification questions or classification criteria |
-| COR-RV-2 | Need verification output format or skill insertion points |
-| COR-MA-1 | Need subagent definitions or prompt templates for deep review |
-| COR-MA-2 | Need coordinator dedup/merge behavior |
-| COR-MA-3 | Need subagent input rules or diff splitting strategy |
-| COR-MA-4 | Need multi-agent insertion points for review skills |
-| COR-SR-1 | Need ranking algorithm for review findings |
-| COR-SR-2 | Need grouping rules for related findings |
-| COR-SR-3 | Need executive summary trigger conditions |
-| COR-SR-4 | Need severity re-ranking output structure or insertion points |
-| COR-CG-1 | Need to understand when and why to compact |
-| COR-CG-2 | Need preserve rules for crafting compact summaries |
-| COR-CG-3 | Need discard rules for dropping low-signal tokens |
-| COR-CG-4 | Need compact summary template or skill-specific examples |
-| COR-AD-1 | Need size detection thresholds or line counting rules |
-| COR-AD-2 | Need lightweight review mode behavior |
-| COR-AD-3 | Need deep review mode behavior (categorization, passes, executive summary) |
-| COR-AD-4 | Need insertion points for adaptive depth in review skills |
-| COR-SS-1 | Need scratchpad purpose, session start behavior, or write triggers |
-| COR-SS-2 | Need scratchpad file format or size limit |
-| COR-SS-3 | Need scratchpad promotion rules or compaction integration |
-| COR-PI-1 | Need phase isolation architecture or coordinator flow |
-| COR-PI-2 | Need sub-agent context template (what to include in prompt) |
-| COR-PI-3 | Need return format schema or field descriptions |
-| COR-PI-4 | Need coordinator processing rules or config settings |
-| COR-DSA-1 | Need discovery sub-agent definitions or prompt templates |
-| COR-DSA-2 | Need return format schema or Codebase Analysis section template |
-| COR-DSA-3 | Need coordinator spawn/collect/merge behavior or error handling |
-| COR-WAVE-1 | Need wave execution architecture or dependency declaration syntax |
-| COR-WAVE-2 | Need wave grouping algorithm or backward compatibility rules |
-| COR-WAVE-3 | Need parallel spawning rules or wave execution summary format |
-| COR-WAVE-4 | Need wave coordinator behavior, file conflict detection, or failure handling |
-| COR-WAVE-5 | Need wave execution configuration, interaction matrix, or aggregation rules |
-| COR-PTV-1 | Need per-task verification architecture or verify-diagnose-repair loop |
-| COR-PTV-2 | Need verify tag syntax, parsing rules, or debug sub-agent schema |
-| COR-PTV-3 | Need verification loop behavior, retry rules, or task_verifications return field |
-| COR-PTV-4 | Need per-task verification configuration, error handling, or wave mode interaction |
-| COR-AC-1 | Need atomic commits architecture, commit format, or sequential mode behavior |
-| COR-AC-2 | Need wave mode commit behavior, JSON schema extension, or coordinator processing |
-| COR-AC-3 | Need atomic commits interaction with phase isolation, wave execution, or config |
-
----
-
-## Quick Reference
-
-### Allowed Patterns Summary
-- **Descriptive Naming**: Clear, self-documenting names
-- **Single Responsibility**: One function = one purpose
-- **Error Handling**: Explicit errors with logging
-- **Type Safety**: Leverage TypeScript types
-- **Code Organization**: Consistent folder structure
-
-### Forbidden Patterns Summary
-- **No Magic Numbers**: Use named constants
-- **No Silent Errors**: Always log and handle
-- **No Nested Ternaries**: Use if/else or switch
-- **No Parameter Mutation**: Return new objects/arrays
-- **No Mixed Async**: Use async/await consistently
-
-### Complexity Levels
-- **0-2 Trivial**: Simple, mechanical changes
-- **3-4 Low**: Straightforward implementation
-- **5-6 Medium**: Moderate complexity, some decisions
-- **7-8 High**: Complex, multiple concerns
-- **9-10 Very High**: Requires careful attention
-
----
-
-## Notes
-
-- `allowed-patterns.md` and `forbidden-patterns.md` have `alwaysApply: true` - they are loaded automatically
-- `project-ledger.md` has `alwaysApply: true` - maintains persistent project memory
-- `complexity-scoring.md` is loaded on-demand when needed for planning
-- `autopilot-mode.md` has `alwaysApply: true` - detects and orchestrates autopilot flow mode
-- `brain-capture.md` is loaded on-demand - processes brain-capture blocks and manages brain index
-- `resource-capture.md` is loaded on-demand - watches for valuable reference materials during skill execution
-- `learn-recommendations.md` is loaded on-demand - detects learning opportunities and recommends `/learn`
-- `pattern-capture.md` is loaded on-demand - silently captures patterns during skill execution and presents for approval
-- `model-routing.md` is loaded on-demand - automatic model selection per phase based on complexity scores during `/execute-plan`
-- `project-tasklist.md` is loaded on-demand - session start tasklist behavior
-- `compaction-guide.md` is loaded on-demand - preserve/discard rules and summary template for `/compact`
-- `session-scratchpad.md` is loaded on-demand - ephemeral per-session notes with promotion to permanent storage
-- `phase-isolation.md` is loaded on-demand - isolated sub-agent execution per phase during `/execute-plan`
-- `project-memory.md` is loaded on-demand - artifact tracking and 7-day session loading
-- `heartbeat.md` is loaded on-demand - scheduled task daemon configuration
-- `discovery-sub-agents.md` is loaded on-demand - parallel codebase exploration sub-agents during `/discovery-plan`
-- `wave-execution.md` is loaded on-demand - wave-based parallel phase execution during `/execute-plan`
-- `per-task-verification.md` is loaded on-demand - per-task verification with debug sub-agents during `/execute-plan`
-- `atomic-commits.md` is loaded on-demand - per-task commit format and coordinator behavior during `/execute-plan`

package/.claude/resources/languages/_index.md

@@ -1,76 +0,0 @@
-
-# Languages Index
-
-## Overview
-
-Language-specific patterns and best practices. These rules apply when working with TypeScript/JavaScript or Python files respectively.
-
-**Total Files**: 2 files, ~316 lines
-**Reference Codes**: LNG-TS-1 through LNG-PY-5
-
----
-
-## Reference Codes
-
-### TypeScript Patterns (`typescript-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| LNG-TS-1 | Type definitions (interfaces, unions, generics) | typescript-patterns.md | 9-50 |
-| LNG-TS-2 | Error handling and custom error types | typescript-patterns.md | 51-65 |
-| LNG-TS-3 | Type safety (utility types, avoid any, null safety) | typescript-patterns.md | 66-86 |
-| LNG-TS-4 | Advanced patterns (const assertions, type guards, immutability, satisfies) | typescript-patterns.md | 87-129 |
-
-### Python Patterns (`python-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| LNG-PY-1 | Style and typing (PEP 8, type hints, dataclasses) | python-patterns.md | 9-52 |
-| LNG-PY-2 | Code organization (modular functions, enums, context managers) | python-patterns.md | 53-97 |
-| LNG-PY-3 | Error handling and custom exceptions | python-patterns.md | 98-110 |
-| LNG-PY-4 | Async and I/O patterns | python-patterns.md | 111-125 |
-| LNG-PY-5 | Best practices (DI, logging, Pydantic, Pathlib) | python-patterns.md | 126-189 |
-
----
-
-## When to Expand
-
-| Code | Expand When |
-|------|-------------|
-| LNG-TS-1 | Defining TypeScript interfaces or unions |
-| LNG-TS-2 | Implementing custom error classes in TS |
-| LNG-TS-3 | Need examples of utility types or null safety |
-| LNG-TS-4 | Using advanced TS features like satisfies or type guards |
-| LNG-PY-1 | Setting up Python project structure or typing |
-| LNG-PY-2 | Organizing Python modules and using enums |
-| LNG-PY-3 | Creating custom Python exceptions |
-| LNG-PY-4 | Implementing async/await in Python |
-| LNG-PY-5 | Using Pydantic, logging, or dependency injection |
-
----
-
-## Quick Reference
-
-### TypeScript Key Points
-- **Strict mode**: Always enable `strict: true`
-- **Interfaces**: Prefer for object shapes
-- **Discriminated unions**: Model exclusive states
-- **Generics**: Reusable, type-safe components
-- **Avoid any**: Use `unknown` with type guards
-- **Immutability**: Use `readonly` and `ReadonlyArray`
-
-### Python Key Points
-- **PEP 8**: Follow naming conventions
-- **Type hints**: Add annotations for clarity
-- **Dataclasses**: Use for structured data
-- **Enums**: Replace magic strings/numbers
-- **Context managers**: Resource management
-- **Logging**: Use logger, not print
-
----
-
-## Notes
-
-- Both files have `alwaysApply: false` - loaded based on file glob patterns
-- TypeScript patterns apply to `**/*.ts` and `**/*.tsx` files
-- Python patterns apply to `**/*.py` files

package/.claude/resources/patterns/_index.md

@@ -1,200 +0,0 @@
-
-# Patterns Index
-
-## Overview
-
-Pattern files provide templates, examples, and guidelines for specific workflows. This is the largest category covering discovery, planning, testing, code review, and contracts.
-
-**Total Files**: 11 files, ~3,420 lines
-**Reference Codes**: PTN-BR-1 through PTN-PR-6
-
----
-
-## Reference Codes
-
-### Brain Patterns (`brain-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-BR-1 | Brain directory structure and file naming conventions | brain-patterns.md | 5-45 |
-| PTN-BR-2 | Wiki-link patterns and brain-capture block per skill | brain-patterns.md | 47-160 |
-| PTN-BR-3 | Feature status lifecycle and index update rules | brain-patterns.md | 162-210 |
-| PTN-BR-4 | Learning subdirectory for teaching curricula | brain-patterns.md | 12-14 |
-
-### Brainstorm Templates (`brainstorm-templates.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-BST-1 | Brainstorm document template with "For Discovery" bridge | brainstorm-templates.md | 5-75 |
-| PTN-BST-2 | Status definitions and file naming conventions | brainstorm-templates.md | 77-105 |
-
-### Contract Patterns (`contract-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-CON-1 | Contract document structure and required sections | contract-patterns.md | 24-44 |
-| PTN-CON-2 | Allowed patterns (TypeScript interfaces, status codes, auth examples) | contract-patterns.md | 47-171 |
-| PTN-CON-3 | Forbidden patterns (no hardcoded secrets, generic types) | contract-patterns.md | 173-250 |
-| PTN-CON-4 | FE integration guidelines (state management, caching) | contract-patterns.md | 252-283 |
-
-### Discovery Patterns (`discovery-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-DIS-1 | What is discovery + folder structure | discovery-patterns.md | 14-47 |
-| PTN-DIS-2 | Naming conventions + question status tracking | discovery-patterns.md | 49-88 |
-| PTN-DIS-3 | Requirements categories (FR, NFR, Constraints) | discovery-patterns.md | 90-109 |
-| PTN-DIS-4 | Allowed discovery patterns | discovery-patterns.md | 112-213 |
-| PTN-DIS-5 | Forbidden discovery patterns | discovery-patterns.md | 215-298 |
-
-### Discovery Templates (`discovery-templates.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-DIST-1 | Discovery document template | discovery-templates.md | 12-94 |
-| PTN-DIST-2 | Spike template | discovery-templates.md | 96-162 |
-| PTN-DIST-3 | Question format examples (functional, technical, UI/UX) | discovery-templates.md | 164-215 |
-| PTN-DIST-4 | Referenced documents analysis example | discovery-templates.md | 217-242 |
-| PTN-DIST-5 | Requirements gathering example | discovery-templates.md | 244-279 |
-| PTN-DIST-6 | Risks and proposed approach examples | discovery-templates.md | 281-330 |
-
-### Jest Patterns (`jest-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-JEST-1 | File naming conventions and test location | jest-patterns.md | 12-56 |
-| PTN-JEST-2 | Test structure (AAA pattern, describe/it blocks) | jest-patterns.md | 58-91 |
-| PTN-JEST-3 | Server and client test setup | jest-patterns.md | 93-160 |
-| PTN-JEST-4 | Mock factories and mocking dependencies | jest-patterns.md | 162-301 |
-| PTN-JEST-5 | Testing async code, errors, hooks, browser APIs | jest-patterns.md | 303-412 |
-| PTN-JEST-6 | Forbidden testing patterns | jest-patterns.md | 414-481 |
-
-### Plans Patterns (`plans-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-PLN-1 | Workflow folder structure | plans-patterns.md | 14-31 |
-| PTN-PLN-2 | Allowed planning patterns (12 patterns) | plans-patterns.md | 39-142 |
-| PTN-PLN-3 | Forbidden planning patterns (13 patterns) | plans-patterns.md | 144-223 |
-
-### Plans Templates (`plans-templates.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-PLNT-1 | Plan document template | plans-templates.md | 12-95 |
-| PTN-PLNT-2 | Phase templates (types, backend, store, UI, integration, tests) | plans-templates.md | 98-188 |
-| PTN-PLNT-3 | Key changes and complexity summary examples | plans-templates.md | 190-238 |
-
-### Pytest Patterns (`pytest-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-PYTEST-1 | File naming and test structure | pytest-patterns.md | 12-77 |
-| PTN-PYTEST-2 | Fixtures and factory fixtures | pytest-patterns.md | 79-173 |
-| PTN-PYTEST-3 | Mocking (basic, class instances, async) | pytest-patterns.md | 175-241 |
-| PTN-PYTEST-4 | Parametrized tests | pytest-patterns.md | 243-276 |
-| PTN-PYTEST-5 | Testing exceptions and context managers | pytest-patterns.md | 278-347 |
-| PTN-PYTEST-6 | Async testing and forbidden patterns | pytest-patterns.md | 349-457 |
-
-### Review Code Templates (`review-code-templates.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-REV-1 | Code review output format template | review-code-templates.md | 12-192 |
-| PTN-REV-2 | Pattern conflict example | review-code-templates.md | 196-232 |
-| PTN-REV-3 | Rule update recommendation example | review-code-templates.md | 234-284 |
-| PTN-REV-4 | Finding example | review-code-templates.md | 286-316 |
-
-### PR Review Patterns (`review-pr-patterns.md`)
-
-| Code | Description | Source | Lines |
-|------|-------------|--------|-------|
-| PTN-PR-1 | General PR review checklist | review-pr-patterns.md | 32-74 |
-| PTN-PR-2 | TypeScript PR review patterns | review-pr-patterns.md | 76-116 |
-| PTN-PR-3 | Python PR review patterns | review-pr-patterns.md | 118-163 |
-| PTN-PR-4 | Forbidden patterns to catch in reviews | review-pr-patterns.md | 165-253 |
-| PTN-PR-5 | Allowed patterns to encourage | review-pr-patterns.md | 255-310 |
-| PTN-PR-6 | Review comment templates and approval criteria | review-pr-patterns.md | 312-371 |
-
----
-
-## When to Expand
-
-### Discovery Workflow
-
-| Code | Expand When |
-|------|-------------|
-| PTN-DIS-1 | Starting discovery, need folder structure |
-| PTN-DIS-3 | Categorizing requirements (FR, NFR, C) |
-| PTN-DIST-1 | Creating a discovery document |
-| PTN-DIST-5 | Need requirements gathering example |
-
-### Planning Workflow
-
-| Code | Expand When |
-|------|-------------|
-| PTN-PLN-1 | Need folder structure reference |
-| PTN-PLN-2 | Need allowed planning patterns |
-| PTN-PLNT-1 | Creating a new plan document |
-| PTN-PLNT-2 | Need phase templates |
-
-### Testing (Jest)
-
-| Code | Expand When |
-|------|-------------|
-| PTN-JEST-1 | Setting up test file naming |
-| PTN-JEST-2 | Need test structure example |
-| PTN-JEST-3 | Setting up server/client tests |
-| PTN-JEST-4 | Need mock factory examples |
-
-### Testing (Pytest)
-
-| Code | Expand When |
-|------|-------------|
-| PTN-PYTEST-1 | Setting up pytest file structure |
-| PTN-PYTEST-2 | Need fixture examples |
-| PTN-PYTEST-3 | Need mocking examples |
-| PTN-PYTEST-4 | Need parametrized test examples |
-
-### Code Review
-
-| Code | Expand When |
-|------|-------------|
-| PTN-REV-1 | Creating code review output |
-| PTN-PR-1 | Need general PR checklist |
-| PTN-PR-2 | Reviewing TypeScript code |
-| PTN-PR-3 | Reviewing Python code |
-
-### Contracts
-
-| Code | Expand When |
-|------|-------------|
-| PTN-CON-1 | Creating a new contract document |
-| PTN-CON-2 | Need contract pattern examples |
-| PTN-CON-4 | Need FE integration guidance |
-
----
-
-## Quick Reference by Category
-
-### Discovery
-- **PTN-DIS-***: Discovery patterns and rules
-- **PTN-DIST-***: Discovery templates and examples
-
-### Planning
-- **PTN-PLN-***: Planning patterns and rules
-- **PTN-PLNT-***: Plan templates
-
-### Testing
-- **PTN-JEST-***: Jest testing patterns (JS/TS)
-- **PTN-PYTEST-***: Pytest testing patterns (Python)
-
-### Reviews
-- **PTN-REV-***: Code review templates
-- **PTN-PR-***: PR review patterns
-
-### Brainstorm
-- **PTN-BST-***: Brainstorm output templates
-
-### Contracts
-- **PTN-CON-***: Integration contract patterns