intentdna 1.7.4 → 1.8.0

package/dist/templates/workflow-evidence-review.dna.yaml

@@ -0,0 +1,198 @@
+# workflow-evidence-review: evidence package review before adoption/evolution/sync
+# Source: extracted from Flutter rewrite dogfood progress JSON, diagnosis reviews, and test logs
+# Purpose: make evidence review a reusable workflow asset instead of an ad hoc manager checklist
+
+version: "0.1.0"
+id: template_workflow_evidence_review
+name: Workflow Evidence Review
+purpose: Review canonical workflow evidence before adoption, evolution, rollout, or runtime sync.
+maturity: reviewed
+fit:
+  - Workflow assets with dogfood, diagnosis, test, or progress evidence that needs authority classification.
+  - Adoption or evolution reviews where weak notes must stay separate from canonical evidence.
+not_for:
+  - Treating chat memory, wiki notes, or dashboard projections as runtime truth.
+  - Automatically mutating workflow assets or evolution markers from evidence.
+inputs:
+  - progress JSON or C5 capture evidence
+  - diagnosis and review verdicts
+  - test logs or workflow references
+outputs:
+  - evidence index
+  - authority classification
+  - manager review packet and next commands
+lineage:
+  source: Flutter rewrite dogfood evidence review pattern
+  reference: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress
+type: project
+namespace: wer
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+evidence:
+  - label: Flutter rewrite dogfood progress JSON
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/.dna/fix-progress
+    description: Module-level progress JSON, test logs, review verdicts, and round summaries used to gate workflow evolution.
+  - label: Flutter rewrite workflow reference
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/docs/refactoring-workflow-v2.md
+    description: Dogfood workflow route that made evidence packages necessary before adoption and sync.
+
+genes:
+  evidence_before_adoption:
+    description: Workflow assets must show canonical evidence before adoption, org binding, evolution mutation, or runtime sync
+    codons:
+      - type: attract
+        target: progress_json_review
+      - type: attract
+        target: test_log_review
+      - type: repel
+        target: chat_memory_as_truth
+      - type: threshold
+        condition: "canonical_evidence_reviewed == true"
+        action: block
+
+  authority_classification:
+    description: Separate canonical machine evidence from weak notes, stale summaries, and unsupported claims
+    codons:
+      - type: attract
+        target: machine_readable_progress_json
+      - type: attract
+        target: reviewer_verdict_json
+      - type: repel
+        target: unsupported_adoption_claim
+      - type: sense
+        signal: evidence_conflict
+        response: escalate_to_human
+
+  preview_first_evolution_gate:
+    description: Evidence can suggest evolution, but marker mutation and sync stay human-reviewed
+    codons:
+      - type: attract
+        target: reviewed_suggestion
+      - type: attract
+        target: preview_before_mutation
+      - type: repel
+        target: automatic_marker_write
+      - type: threshold
+        condition: "evolution_mutation_without_review == false"
+        action: block
+
+contexts: {}
+
+roles:
+  evidence_collector:
+    description: Collects canonical evidence sources without changing workflow assets or runtime artifacts
+    tool_permissions:
+      allow: [Read, Grep, Glob, Bash]
+      deny: [Edit, Write, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: []
+    instructions:
+      - "Collect only canonical evidence paths: progress JSON, review verdict JSON, diagnosis specs, test logs, and workflow references."
+      - Treat Obsidian/wiki notes as internal memory only; do not upgrade them to product evidence.
+      - Summarize missing, stale, unreadable, or conflicting evidence explicitly.
+      - Do not edit templates, org profiles, sync artifacts, or evolution markers.
+
+  evidence_classifier:
+    description: Classifies evidence authority, adoption readiness, and evolution risk
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: []
+    instructions:
+      - Separate canonical machine-readable evidence from human notes and chat summaries.
+      - Mark each claim as proven, weak, contradicted, missing, or needs human review.
+      - Identify whether adoption, org bind, evolution preview, marker mutation, or runtime sync is allowed.
+      - If active dogfood evidence remains, route to suggestions and draft workflow changes before mutation.
+
+  manager_reviewer:
+    description: Produces a manager-readable adoption/evolution/sync review packet
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", ".dna/**", "docs/**"]
+      write: []
+    instructions:
+      - Produce a concise review packet with decision, evidence gate, blockers, and next commands.
+      - Never approve sync or marker mutation from weak evidence.
+      - "Keep recommendations explicit: inspect, suggestions, draft, diff, adoption, org bind, rollout, sync."
+      - End with a mutation boundary statement.
+
+workflows:
+  evidence-review:
+    name: Evidence Review
+    description: Collect, classify, and review workflow evidence before adoption, evolution, org rollout, or runtime sync.
+    steps:
+      - id: collect-evidence
+        role: evidence_collector
+        description: Collect canonical workflow, dogfood, diagnosis, review, and test evidence.
+        prompt: "Collect evidence for {{asset}} from {{evidence_path}}. Include progress JSON, review verdicts, diagnosis specs, test logs, and workflow references. Do not mutate anything."
+        checkpoints:
+          - assert: clean_working_tree
+            message: "Evidence collection should not mutate workflow assets or runtime artifacts."
+            action: warn
+        handoff:
+          produces:
+            - type: summary
+              name: evidence_index
+              description: Canonical evidence paths, missing sources, stale sources, and conflicts.
+      - id: classify-authority
+        role: evidence_classifier
+        description: Classify evidence authority and adoption/evolution readiness.
+        depends_on: [collect-evidence]
+        prompt: "Classify each evidence claim for {{asset}} as proven, weak, contradicted, missing, or needs human review. Decide whether adoption, org bind, evolution preview, marker mutation, rollout, or sync is allowed."
+        checkpoints:
+          - assert: clean_working_tree
+            message: "Unsupported adoption/evolution/sync claims must remain visible."
+            action: warn
+        handoff:
+          consumes:
+            - type: summary
+              name: evidence_index
+              from: collect-evidence
+              description: Evidence source index.
+          produces:
+            - type: summary
+              name: authority_review
+              description: Evidence authority, risk, and allowed next commands.
+      - id: manager-review
+        role: manager_reviewer
+        description: Produce the manager review packet and next commands.
+        depends_on: [classify-authority]
+        prompt: "Prepare a manager review for {{asset}}. Include decision, evidence gate, blockers, allowed next commands, and mutation boundary. Never recommend sync or marker mutation when evidence is weak, active, or contradicted."
+        checkpoints:
+          - assert: clean_working_tree
+            message: "The review must state whether mutation/sync is allowed or blocked."
+            action: warn
+        handoff:
+          consumes:
+            - type: summary
+              name: authority_review
+              from: classify-authority
+              description: Evidence authority and allowed next commands.
+          produces:
+            - type: summary
+              name: manager_review_packet
+              description: Manager-facing adoption/evolution/sync review packet.
+
+controllers:
+  evidence-review-gate:
+    name: Evidence Review Gate
+    description: "Run evidence collection, authority classification, and manager review before adoption, evolution, rollout, or sync."
+    kind: sequential
+    workflow: evidence-review
+    max_rounds: 1
+    progress_artifact_path: ".dna/evidence-review/$ARGUMENTS.json"
+    roles:
+      evidence_collector: evidence_collector
+      evidence_classifier: evidence_classifier
+      manager_reviewer: manager_reviewer
+    stop_format: configured_stop_report

package/dist/templates/workflow-module-inventory.dna.yaml

@@ -0,0 +1,257 @@
+# workflow-module-inventory: module and feature inventory before behavior lock, rewrite, rollout, or sync
+# Source: extracted from Flutter rewrite dogfood Phase 0 global scan and v1 feature inventory
+# Purpose: make "inventory before per-module execution" a reusable workflow asset
+
+version: "0.1.0"
+id: template_workflow_module_inventory
+name: Workflow Module Inventory
+purpose: Scan modules, pages, actions, evidence gaps, and priorities before per-module workflow execution starts.
+maturity: reviewed
+fit:
+  - Broad migrations, rewrites, or audits that need a source-backed module inventory first.
+  - Teams planning behavior locks, diagnosis reviews, fix loops, or rollout by module.
+not_for:
+  - Starting parallel fixes without source-backed scope and priority.
+  - Inferring inventory from chat memory or stale plans.
+inputs:
+  - source project or legacy implementation path
+  - existing tests and route/module entrypoints
+  - target inventory and priority artifact paths
+outputs:
+  - module/page/action inventory
+  - reviewed inventory verdict
+  - prioritized workflow route
+lineage:
+  source: Flutter rewrite Phase 0 dogfood inventory
+  reference: /Users/samuel/lawark/lwk_flutter_v2-rewrite/docs/v1-feature-inventory.md
+type: project
+namespace: wmi
+
+cascade:
+  inherits: ["species:default"]
+  priority: 100
+
+variables:
+  source_path:
+    description: "Source project or legacy implementation path to inventory"
+    default: "$ARGUMENTS"
+  inventory_path:
+    description: "Module and feature inventory artifact path"
+    default: "docs/v1-feature-inventory.md"
+  behavior_docs_dir:
+    description: "Per-module behavior document directory"
+    default: "docs/behavior"
+  priority_path:
+    description: "Prioritized module route artifact path"
+    default: ".dna/module-inventory/$ARGUMENTS-priority.json"
+
+evidence:
+  - label: Flutter rewrite workflow Phase 0 inventory
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/docs/refactoring-workflow-v2.md
+    description: Dogfood workflow doctrine that starts with a global scan to produce module inventory before per-module behavior locks and fixes.
+  - label: Flutter rewrite v1 feature inventory
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/docs/v1-feature-inventory.md
+    description: Real module/page/action inventory created before module-level behavior documents and rewrite execution.
+  - label: Flutter rewrite behavior documents
+    kind: reference
+    path: /Users/samuel/lawark/lwk_flutter_v2-rewrite/docs/behavior
+    description: Per-module behavior documents generated after inventory to lock action chains before implementation.
+
+genes:
+  inventory_before_execution:
+    description: A broad migration or rewrite starts with module/page/action inventory before per-module execution
+    codons:
+      - type: attract
+        target: global_module_inventory
+      - type: attract
+        target: page_action_map
+      - type: repel
+        target: start_fixing_without_inventory
+      - type: threshold
+        condition: "module_inventory_exists == true"
+        action: block
+
+  source_truth_only:
+    description: Inventory is derived from source code and runnable artifacts, not memory or stale plans
+    codons:
+      - type: attract
+        target: source_code_scan
+      - type: attract
+        target: canonical_artifact_paths
+      - type: repel
+        target: chat_memory_as_inventory_truth
+      - type: sense
+        signal: missing_source_path
+        response: escalate_to_human
+
+  prioritize_before_parallel_work:
+    description: Prioritize modules before starting parallel behavior locks, diagnosis, fixes, or rollout
+    codons:
+      - type: attract
+        target: priority_queue
+      - type: attract
+        target: one_module_per_session
+      - type: repel
+        target: unbounded_parallel_rewrite
+      - type: threshold
+        condition: "module_priority_route_written == true"
+        action: block
+
+contexts: {}
+
+roles:
+  inventory_scanner:
+    description: Scans the source project and creates a module/page/action inventory without editing app code.
+    tool_permissions:
+      allow: [Read, Grep, Glob, Write]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*"]
+      write: ["docs/**", ".dna/module-inventory/**"]
+    instructions:
+      - Read {{source_path}} and identify modules, screens/pages, user-visible actions, services, routes, and existing tests.
+      - Produce {{inventory_path}} with module names, page/action lists, source paths, likely behavior-doc needs, and unknowns.
+      - Treat source code and existing test files as truth; do not infer inventory from chat memory or Obsidian/wiki notes.
+      - Do not edit app code, tests, workflow assets, org profiles, runtime artifacts, or evolution markers.
+
+  inventory_reviewer:
+    description: Reviews the inventory for missing modules, weak evidence, duplicates, and unclear ownership.
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", "docs/**", ".dna/**"]
+      write: []
+    instructions:
+      - Read {{inventory_path}} and sample source paths to verify module/page/action coverage.
+      - Flag duplicated modules, missing entrypoints, missing tests, unclear ownership, and weak source evidence.
+      - Reject inventory claims that are not backed by source paths or runnable artifacts.
+      - Return APPROVE, REQUEST_CHANGES, or BLOCKED with concise reasons.
+
+  route_planner:
+    description: Turns reviewed inventory into a prioritized module route and follow-up workflow commands.
+    tool_permissions:
+      allow: [Read, Write, Grep, Glob]
+      deny: [Edit, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", "docs/**", ".dna/**"]
+      write: [".dna/module-inventory/**"]
+    instructions:
+      - Write {{priority_path}} with priority, module, source paths, recommended next workflow, evidence gaps, and owner.
+      - Recommend behavior lock for modules without behavior docs.
+      - Recommend diagnosis review before implementation for risky rewrite modules.
+      - Keep one-module-per-session discipline visible.
+      - Do not bind organizations, sync runtimes, deploy public surfaces, or mutate evolution markers.
+
+  manager_reviewer:
+    description: Produces a manager-readable inventory route before adoption, rollout, runtime sync, or evolution.
+    tool_permissions:
+      allow: [Read, Grep, Glob]
+      deny: [Edit, Write, Bash, NotebookEdit]
+    scope:
+      read: ["**/*", "docs/**", ".dna/**"]
+      write: []
+    instructions:
+      - Read {{inventory_path}} and {{priority_path}}.
+      - Summarize scope, module count, top priorities, blockers, and next commands.
+      - State which modules should go to behavior lock, diagnosis review, fix-review loop, completion audit, or runtime smoke.
+      - Keep Obsidian/wiki as internal memory only; use inventory and route artifacts as product evidence.
+
+workflows:
+  module-inventory:
+    name: Module Inventory
+    description: Scan source modules, review module/page/action coverage, and produce a prioritized route before per-module workflow execution.
+    steps:
+      - id: scan-inventory
+        role: inventory_scanner
+        description: Build the source-backed module/page/action inventory.
+        prompt: |
+          Build a module inventory for $ARGUMENTS from {{source_path}}.
+          Produce {{inventory_path}} with modules, pages/screens, user-visible actions, source paths, existing tests, unknowns, and behavior-doc needs.
+          Do not edit app code or runtime artifacts.
+        checkpoints:
+          - assert: inventory_artifact_written
+            command: "test -s \"{{inventory_path}}\""
+            message: "Module inventory must exist before review or per-module workflow execution."
+            action: block
+        handoff:
+          produces:
+            - type: file
+              path: "{{inventory_path}}"
+              description: Source-backed module/page/action inventory.
+      - id: review-inventory
+        role: inventory_reviewer
+        depends_on: [scan-inventory]
+        description: Review inventory coverage and evidence strength.
+        prompt: |
+          Review {{inventory_path}} for $ARGUMENTS.
+          Check source-backed module coverage, duplicates, missing entrypoints, weak evidence, missing tests, and unclear ownership.
+          Return APPROVE, REQUEST_CHANGES, or BLOCKED.
+        handoff:
+          consumes:
+            - type: file
+              path: "{{inventory_path}}"
+              from: scan-inventory
+              description: Module inventory.
+          produces:
+            - type: summary
+              name: inventory_review_verdict
+              description: Inventory coverage verdict, missing evidence, and required changes.
+      - id: plan-route
+        role: route_planner
+        depends_on: [review-inventory]
+        description: Create a prioritized module route from reviewed inventory.
+        prompt: |
+          Write {{priority_path}} for $ARGUMENTS.
+          Include module priorities, source paths, recommended next workflow, evidence gaps, and owner.
+          Route modules to behavior lock, diagnosis review, fix-review loop, completion audit, or runtime smoke as appropriate.
+        checkpoints:
+          - assert: module_priority_route_written
+            command: "test -s \"{{priority_path}}\""
+            message: "Prioritized module route must exist before manager route."
+            action: block
+        handoff:
+          consumes:
+            - type: summary
+              name: inventory_review_verdict
+              from: review-inventory
+              description: Inventory review verdict.
+          produces:
+            - type: file
+              path: "{{priority_path}}"
+              description: Prioritized module route JSON.
+      - id: manager-route
+        role: manager_reviewer
+        depends_on: [plan-route]
+        description: Produce manager-readable inventory route and next commands.
+        prompt: |
+          Read {{inventory_path}} and {{priority_path}} for $ARGUMENTS.
+          Summarize module count, top priorities, blockers, and next commands.
+          Do not approve organization rollout, runtime sync, deployment, or evolution mutation from inventory alone.
+        handoff:
+          consumes:
+            - type: file
+              path: "{{priority_path}}"
+              from: plan-route
+              description: Prioritized module route.
+          produces:
+            - type: summary
+              name: manager_inventory_route
+              description: Manager-readable module inventory route and next workflow commands.
+
+controllers:
+  module-inventory:
+    name: Module Inventory
+    description: "Run module inventory, review, priority routing, and manager route before per-module execution."
+    kind: sequential
+    workflow: module-inventory
+    max_rounds: 1
+    progress_artifact_path: ".dna/module-inventory/$ARGUMENTS.controller.json"
+    roles:
+      inventory_scanner: inventory_scanner
+      inventory_reviewer: inventory_reviewer
+      route_planner: route_planner
+      manager_reviewer: manager_reviewer
+    stop_format: configured_stop_report