arggon-harness 0.1.0

package/src/templates/design-wireframe.yaml

@@ -0,0 +1,114 @@
+# Wireframe Template
+#
+# Instructions:
+# - Define pages, layout regions, component placements, user flows, and annotations
+# - Use kebab-case for all IDs
+# - Position coordinates use a 12-column grid system (0-11)
+# - Remove comment lines (starting with #) before saving
+
+id: <change-name>
+schema: <schema-name>
+
+agent:
+  context_files:
+    - <relevant files>
+  affected_paths:
+    - <paths affected>
+
+body:
+  pages:
+    - id: <page-id>
+      name: <page display name>
+      description: |
+        <what this page does>
+      layout:
+        - region: <header|sidebar|main|footer|aside>
+          order: <numeric order>
+          style: <optional css hints>
+      components:
+        - id: <component-id>
+          type: <button|card|input|table|navigation|modal|form>
+          region: <which region this goes in>
+          position:
+            x: <column start 0-11>
+            y: <row>
+          size:
+            width: <column span 1-12>
+            height: <row span>
+          properties:
+            label: <optional label>
+            placeholder: <optional placeholder>
+            variant: <primary|secondary|ghost|outline>
+
+    - id: <another-page-id>
+      name: <another page name>
+      description: |
+        <what this page does>
+      layout:
+        - region: header
+          order: 1
+          style: <optional css hints>
+        - region: main
+          order: 2
+          style: <optional css hints>
+        - region: footer
+          order: 3
+          style: <optional css hints>
+      components:
+        - id: <component-id>
+          type: <button|card|input|table|navigation|modal|form>
+          region: main
+          position:
+            x: <column start 0-11>
+            y: <row>
+          size:
+            width: <column span 1-12>
+            height: <row span>
+          properties:
+            label: <optional label>
+            variant: <primary|secondary|ghost|outline>
+
+  flows:
+    user_flows:
+      - id: <flow-id>
+        name: <flow name>
+        description: |
+          <what this flow achieves>
+        steps:
+          - id: <step-id>
+            from_page: <page-id>
+            to_page: <page-id>
+            trigger: <click|submit|hover|scroll|auto>
+            description: |
+              <what happens in this step>
+
+      - id: <another-flow-id>
+        name: <another flow name>
+        description: |
+          <what this flow achieves>
+        steps:
+          - id: <step-id>
+            from_page: <page-id>
+            to_page: <page-id>
+            trigger: <click|submit|hover|scroll|auto>
+            description: |
+              <what happens in this step>
+          - id: <step-id>
+            from_page: <page-id>
+            to_page: <page-id>
+            trigger: <click|submit|hover|scroll|auto>
+            description: |
+              <what happens in this step>
+
+  annotations:
+    - id: <annotation-id>
+      page_id: <optional page reference>
+      note: |
+        <design note or constraint>
+      category: <constraint|edge_case|decision|question>
+
+    - id: <another-annotation-id>
+      page_id: <optional page reference>
+      note: |
+        <design note or constraint>
+      category: <constraint|edge_case|decision|question>

package/src/templates/proposal.yaml

@@ -0,0 +1,43 @@
+# Proposal Template
+# 
+# Instructions:
+# - Replace <placeholders> with actual values
+# - Remove comment lines (starting with #) before saving
+# - Keep the structure intact
+
+id: <change-name-kebab-case>
+schema: <schema-name>
+created: <YYYY-MM-DD>
+status: active
+
+agent:
+  priority: <low|medium|high>
+  context_files:
+    - <file1.ts>
+    - <file2.ts>
+  affected_paths:
+    - <src/path/**>
+  hints:
+    - <implementation hint>
+
+body:
+  why: |
+    <1-3 sentences explaining the problem and why this change is needed>
+  
+  what_changes:
+    - <bullet point describing a change>
+    - <another change>
+  
+  capabilities:
+    new:
+      - id: <capability-id>
+        description: <what this capability does>
+    modified:
+      - id: <existing-capability-id>
+        description: <what changed>
+  
+  impact:
+    - path: <src/file.ts>
+      change: <what changes in this file>
+    - path: <src/another.ts>
+      change: <description>

package/src/templates/registry.yaml

@@ -0,0 +1,3 @@
+changes: []
+
+last_updated: <timestamp>

package/src/templates/spec.yaml

@@ -0,0 +1,56 @@
+# Delta Spec Template
+#
+# Instructions:
+# - One file per capability
+# - Use operations: add, modify, remove, rename
+# - Each requirement must have at least one scenario
+# - Add verify blocks for testable assertions
+
+capability: <capability-id>
+version: 1
+
+agent:
+  related_specs:
+    - <other-capability>
+  affected_paths:
+    - <src/auth/**>
+
+operations:
+  - op: add
+    requirement:
+      id: <requirement-id>
+      description: |
+        The system SHALL <behavior description>.
+      scenarios:
+        - id: <scenario-id>
+          given:
+            - <precondition>
+          when:
+            - <action or event>
+          then:
+            - <expected outcome>
+          verify:
+            - type: assertion
+              code: "<testable assertion>"
+  
+  # Example modify operation:
+  # - op: modify
+  #   requirement:
+  #     id: <existing-requirement-id>
+  #     description: |
+  #       <complete updated requirement>
+  #     scenarios:
+  #       - id: <scenario-id>
+  #         given: [...]
+  #         when: [...]
+  #         then: [...]
+  
+  # Example remove operation:
+  # - op: remove
+  #   requirement:
+  #     id: <requirement-to-remove>
+  
+  # Example rename operation:
+  # - op: rename
+  #   from: <old-id>
+  #   to: <new-id>

package/src/templates/tasks.yaml

@@ -0,0 +1,58 @@
+# Tasks Template
+#
+# Instructions:
+# - Break implementation into concrete tasks
+# - Each task should be completable in one session
+# - Order by dependency (what must be done first?)
+# - Use tdd_phase for TDD workflows
+
+workflow: <schema-name>
+
+agent:
+  critical_path:
+    - <task-id>
+    - <task-id>
+  total_estimated_minutes: <total>
+
+tasks:
+  - id: t1
+    group: <group-name>
+    description: <specific task description>
+    depends_on: []
+    complexity: <low|medium|high>
+    estimated_minutes: <minutes>
+    spec_refs:
+      - <capability/requirement>
+    affected_files:
+      - <src/file.ts>
+    acceptance:
+      - <acceptance criterion>
+    status: pending
+    # tdd_phase: <red|green|refactor>  # Uncomment for TDD
+  
+  - id: t2
+    group: <group-name>
+    description: <another task>
+    depends_on: [t1]
+    complexity: <low|medium|high>
+    estimated_minutes: <minutes>
+    spec_refs:
+      - <capability/requirement>
+    affected_files:
+      - <src/file.ts>
+    acceptance:
+      - <acceptance criterion>
+    status: pending
+  
+  - id: t3
+    group: Verify
+    description: Run all tests and verify acceptance
+    depends_on: [t1, t2]
+    complexity: low
+    estimated_minutes: 15
+    spec_refs: []
+    affected_files: []
+    acceptance:
+      - All tests pass
+      - No linting errors
+    status: pending