@guanlin4924/devflow-pi 0.1.0

package/plugins/devflow-core/skills/workflow-project-context/assets/rules-index-template.md

@@ -0,0 +1,80 @@
+# Project Rules Index
+
+<!-- project_context_run_id: {{run_id}}; code_index_status: {{code_index_status}}; code_index_skip_reason: {{code_index_skip_reason}} -->
+
+## Quick Reference
+
+| Rule File | Purpose | Status |
+|-----------|---------|--------|
+| `.planning/execution-contract.md` | Layer order, TDD strategy, codegen and verification gates | {{execution_contract_status}} |
+| `.planning/toolchain.md` | Build, test, lint, mock, migration commands | {{toolchain_status}} |
+| `.planning/lessons/README.md` | Cross-milestone lessons learned | {{lessons_status}} |
+| `.planning/code-index/` | Machine code facts: symbols, relations, entrypoints, and data flow | {{code_index_status}} |
+| `.context/spec/design/` | Frontend UI/UX recommendations and project-level design tokens | {{design_rule_pack_status}} |
+| `.context/spec/index.md` | Generated technical spec registry and read order | {{context_spec_index_status}} |
+| `.context/spec/stacks/` | Generated stack-level technical specs | {{stack_specs_status}} |
+| `.context/workflow/` | Existing workflow gates (TDD, verification, checklist) | {{context_workflow_status}} |
+| `.context/lessons/README.md` | Legacy project lessons | {{context_lessons_status}} |
+| `AGENTS.md` / `CLAUDE.md` | Root agent instructions | {{root_instructions_status}} |
+| `.cursorrules` | IDE-level AI rules | {{cursorrules_status}} |
+
+## Frontend Rules
+
+| Rule File | Path | Status |
+|-----------|------|--------|
+| Frontend Spec Index | `.context/spec/frontend/index.md` | {{frontend_spec_index_status}} |
+| Frontend Specs | `.context/spec/frontend/` | {{frontend_specs_status}} |
+| Design Specs | `.context/spec/design/` | {{design_specs_status}} |
+
+## Backend Rules
+
+| Rule File | Path | Status |
+|-----------|------|--------|
+| Backend Spec Index | `.context/spec/backend/index.md` | {{backend_spec_index_status}} |
+| Backend Specs | `.context/spec/backend/` | {{backend_specs_status}} |
+
+## Stack Specs
+
+| Stack Key | Path | Codebases | Status |
+|-----------|------|-----------|--------|
+| {{stack_key}} | `.context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{stack_spec_status}} |
+
+## Codebase Specs
+
+| Codebase | Type | Stack Key | Path | Status |
+|----------|------|-----------|------|--------|
+| {{codebase_name}} | {{codebase_type}} | {{stack_key}} | `.context/spec/{{domain}}/{{codebase_name}}.md` | {{codebase_spec_status}} |
+
+## Spec Read Contract
+
+Downstream skills must read technical rules in this order:
+
+1. `.planning/rules/INDEX.md`
+2. `.context/spec/index.md`
+3. Matching `.context/spec/stacks/{stack_key}.md`
+4. Matching `.context/spec/frontend|backend/{codebase}.md`
+5. Matching `.context/spec/{domain}/index.md` and applicable depth specs
+6. Matching `.planning/navigation/{codebase}.md`
+7. `.planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
+8. Actual source files
+
+## Workflow Rules
+
+| Rule File | Path | Status |
+|-----------|------|--------|
+| TDD Gate | `.context/workflow/tdd.md` | {{tdd_status}} |
+| Verification Gate | `.context/workflow/verification.md` | {{verification_status}} |
+| Checklist | `.context/workflow/checklist.md` | {{checklist_status}} |
+
+## History Model
+
+| Source | Role | Status |
+|--------|------|--------|
+| `.planning/milestones/` | Archived milestone summaries | {{milestones_status}} |
+| `.planning/requirements/` | Requirement baselines | {{requirements_status}} |
+| `.planning/lessons/` | Cross-milestone lessons | {{planning_lessons_status}} |
+| `.planning/*/CONTEXT.md` | Phase/session decisions | {{context_md_status}} |
+
+---
+
+*Generated during project initialization. This index is the first file downstream skills read. Update as rule files are added or change status.*

package/plugins/devflow-core/skills/workflow-project-context/assets/run-manifest-template.json

@@ -0,0 +1,40 @@
+{
+  "version": 1,
+  "run_id": "{{run_id}}",
+  "started_at": "{{run_started_at}}",
+  "mode": "{{full_or_fast}}",
+  "code_index_status": "{{complete_or_skipped}}",
+  "code_index_skip_reason": "{{code_index_skip_reason}}",
+  "design_rule_pack": {
+    "status": "{{installed_or_not_applicable}}",
+    "reason": "{{design_rule_pack_reason}}",
+    "source": "{{design_rule_pack_source_or_none}}",
+    "assets": ["{{verified_design_asset_or_none}}"]
+  },
+  "topic_inventory": [
+    {
+      "codebase": "{{codebase_name}}",
+      "domain": "{{backend_or_frontend}}",
+      "candidate_topics": ["{{candidate_topic}}"],
+      "discovered_topics": ["{{discovered_topic}}"]
+    }
+  ],
+  "depth_specs": [
+    {
+      "codebase": "{{codebase_name}}",
+      "codebase_root": "{{absolute_or_project_relative_codebase_root}}",
+      "domain": "{{backend_or_frontend}}",
+      "topic": "{{topic}}",
+      "path": "{{depth_spec_path}}",
+      "source_paths": ["{{relative_source_path}}"],
+      "source_fingerprint": "{{source_fingerprint}}"
+    }
+  ],
+  "not_applicable_topics": [
+    {
+      "codebase": "{{codebase_name}}",
+      "domain": "{{backend_or_frontend}}",
+      "topic": "{{topic}}"
+    }
+  ]
+}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/directory-structure.md

@@ -0,0 +1,46 @@
+# Directory Structure Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains the `{{codebase_path}}` directory layout and source ownership.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Directory Layout
+
+{{directory_tree}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/engine.md

@@ -0,0 +1,46 @@
+# Engine Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains execution engine modules in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/errors.md

@@ -0,0 +1,46 @@
+# Errors Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains backend error handling and response mapping.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/locator.md

@@ -0,0 +1,46 @@
+# Locator Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains UI locator scan/validate behavior.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/model.md

@@ -0,0 +1,46 @@
+# Model Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains ORM models and database setup in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/repository.md

@@ -0,0 +1,46 @@
+# Repository / DAO Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains repository, DAO, and persistence adapter modules in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/router.md

@@ -0,0 +1,46 @@
+# Router Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains router modules in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/scheduler.md

@@ -0,0 +1,46 @@
+# Scheduler Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains scheduled task behavior in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/schema.md

@@ -0,0 +1,46 @@
+# Schema Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains Pydantic/{{type_label}} schemas in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/service.md

@@ -0,0 +1,46 @@
+# Service Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains service modules in `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/backend/testing.md

@@ -0,0 +1,46 @@
+# Testing Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains backend verification for changes under `{{scope_path}}`.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}

package/plugins/devflow-core/skills/workflow-project-context/assets/spec-templates/frontend/api-client.md

@@ -0,0 +1,46 @@
+# API Client Specification
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Source fingerprint: `{{source_fingerprint}}`
+- Regenerate when: matched source paths or navigation facts change.
+
+## Scope
+
+This file constrains API communication in the frontend codebase.
+
+## Source Summary
+
+| Source | Type | Confidence |
+|---|---|---|
+{{source_summary}}
+
+## Stack-Specific Conventions
+
+<!-- Extract from the matching `## Per-Layer Rules` subsection in the stack spec. -->
+{{stack_layer_rules}}
+
+## Observed Patterns
+
+<!-- Extract from navigation scan, call-chain tracing, explicit rule files, and lessons. -->
+{{observed_rules}}
+
+## Rules
+
+| Rule | Strength | Source | Notes |
+|---|---|---|---|
+{{rules_table}}
+
+## Current Project Shape
+
+{{current_shape}}
+
+## Not Applicable
+
+{{not_applicable}}
+
+## Pending Confirmation
+
+{{pending}}