macro-agent 0.1.0 → 0.1.2

package/references/openteams/examples/get-shit-done/roles/debugger.yaml

@@ -0,0 +1,8 @@
+name: debugger
+display_name: GSD Debugger
+description: "Systematic root-cause investigation using the scientific method. Maintains persistent debug state in .planning/debug/. Hypothesis-driven with explicit confidence levels."
+capabilities:
+  - root-cause-analysis
+  - hypothesis-testing
+  - debug-state-management
+  - scientific-method

package/references/openteams/examples/get-shit-done/roles/executor.yaml

@@ -0,0 +1,8 @@
+name: executor
+display_name: GSD Executor
+description: "Atomically executes PLAN.md tasks. Handles deviations via 4 rules (security, validation, blocking, discretionary). Commits per task. Pauses at checkpoints."
+capabilities:
+  - task-execution
+  - deviation-handling
+  - atomic-commits
+  - checkpoint-management

package/references/openteams/examples/get-shit-done/roles/integration-checker.yaml

@@ -0,0 +1,8 @@
+name: integration-checker
+display_name: GSD Integration Checker
+description: "Cross-phase verification. Ensures exports are imported, APIs are consumed, E2E flows are connected. Catches integration gaps between independently developed phases."
+capabilities:
+  - cross-phase-verification
+  - api-contract-validation
+  - e2e-flow-verification
+  - integration-gap-detection

package/references/openteams/examples/get-shit-done/roles/orchestrator.yaml

@@ -0,0 +1,9 @@
+name: orchestrator
+display_name: GSD Orchestrator
+description: "Command-level orchestrator. Routes user commands to agent chains, manages project state, spawns agents in dependency-aware waves, handles checkpoint resumption."
+capabilities:
+  - command-routing
+  - wave-orchestration
+  - state-management
+  - checkpoint-handling
+  - context-budgeting

package/references/openteams/examples/get-shit-done/roles/phase-researcher.yaml

@@ -0,0 +1,7 @@
+name: phase-researcher
+display_name: GSD Phase Researcher
+description: "Phase-specific research producing RESEARCH.md with stack options, implementation patterns, and pitfalls. Respects CONTEXT.md constraints from prior discussions."
+capabilities:
+  - phase-research
+  - pattern-analysis
+  - constraint-aware-research

package/references/openteams/examples/get-shit-done/roles/plan-checker.yaml

@@ -0,0 +1,8 @@
+name: plan-checker
+display_name: GSD Plan Checker
+description: "Pre-execution validation across 7 dimensions: requirement coverage, task completeness, dependencies, key links, scope, must-haves, and context compliance."
+capabilities:
+  - plan-validation
+  - requirement-tracing
+  - dependency-verification
+  - scope-analysis

package/references/openteams/examples/get-shit-done/roles/planner.yaml

@@ -0,0 +1,8 @@
+name: planner
+display_name: GSD Planner
+description: "Decomposes phases into 2-3 parallel tasks with dependency graphs. Applies goal-backward methodology. Sizes tasks for 15-60 min agent execution. Produces PLAN.md."
+capabilities:
+  - task-decomposition
+  - dependency-analysis
+  - goal-backward-planning
+  - vertical-slice-design

package/references/openteams/examples/get-shit-done/roles/project-researcher.yaml

@@ -0,0 +1,8 @@
+name: project-researcher
+display_name: GSD Project Researcher
+description: "Domain ecosystem research for new projects. Produces 5 outputs: SUMMARY.md, STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md."
+capabilities:
+  - domain-research
+  - ecosystem-analysis
+  - technology-evaluation
+  - risk-identification

package/references/openteams/examples/get-shit-done/roles/research-synthesizer.yaml

@@ -0,0 +1,7 @@
+name: research-synthesizer
+display_name: GSD Research Synthesizer
+description: "Integrates 4 parallel researcher outputs into cohesive SUMMARY.md for roadmapper consumption. Resolves conflicts between research findings."
+capabilities:
+  - research-synthesis
+  - conflict-resolution
+  - summary-generation

package/references/openteams/examples/get-shit-done/roles/roadmapper.yaml

@@ -0,0 +1,7 @@
+name: roadmapper
+display_name: GSD Roadmapper
+description: "Converts requirements into delivery phases where every v1 requirement maps to exactly one phase. Produces ROADMAP.md with 2-5 phases, each with success criteria."
+capabilities:
+  - requirements-decomposition
+  - phase-planning
+  - success-criteria-definition

package/references/openteams/examples/get-shit-done/roles/verifier.yaml

@@ -0,0 +1,8 @@
+name: verifier
+display_name: GSD Verifier
+description: "Post-execution verification using 10-step goal-backward methodology. Verifies objectives are achieved, not just tasks completed. Produces VERIFICATION.md with gap analysis."
+capabilities:
+  - goal-backward-verification
+  - gap-analysis
+  - acceptance-testing
+  - objective-validation

package/references/openteams/examples/get-shit-done/team.yaml

@@ -0,0 +1,154 @@
+name: get-shit-done
+description: "GSD — prompt-native multi-agent system for autonomous codebase development with wave-based parallel execution, goal-backward verification, and checkpoint-based context management"
+version: 1
+roles:
+  - orchestrator
+  - roadmapper
+  - planner
+  - plan-checker
+  - executor
+  - verifier
+  - project-researcher
+  - phase-researcher
+  - research-synthesizer
+  - codebase-mapper
+  - debugger
+  - integration-checker
+
+topology:
+  root:
+    role: orchestrator
+    prompt: prompts/orchestrator.md
+  companions:
+    - role: roadmapper
+      prompt: prompts/roadmapper.md
+    - role: verifier
+      prompt: prompts/verifier.md
+  spawn_rules:
+    orchestrator: [roadmapper, planner, plan-checker, executor, verifier, project-researcher, phase-researcher, research-synthesizer, codebase-mapper, debugger, integration-checker]
+    planner: []
+    plan-checker: []
+    executor: []
+    verifier: []
+    roadmapper: []
+    project-researcher: []
+    phase-researcher: []
+    research-synthesizer: []
+    codebase-mapper: []
+    debugger: []
+    integration-checker: []
+
+communication:
+  enforcement: permissive
+
+  channels:
+    project_lifecycle:
+      description: "High-level project state transitions"
+      signals: [PROJECT_INITIALIZED, PHASE_STARTED, PHASE_COMPLETE, MILESTONE_COMPLETE]
+    planning_events:
+      description: "Planning and research workflow signals"
+      signals: [RESEARCH_COMPLETE, ROADMAP_READY, PLAN_READY, PLAN_VALIDATED, PLAN_REJECTED]
+    execution_events:
+      description: "Task execution and wave coordination"
+      signals: [WAVE_STARTED, TASK_COMPLETE, WAVE_COMPLETE, CHECKPOINT_REACHED, DEVIATION_DETECTED]
+    verification_events:
+      description: "Quality verification and gap detection"
+      signals: [VERIFICATION_PASSED, GAPS_FOUND, UAT_COMPLETE, INTEGRATION_VERIFIED]
+
+  subscriptions:
+    orchestrator:
+      - channel: project_lifecycle
+      - channel: planning_events
+      - channel: execution_events
+      - channel: verification_events
+    roadmapper:
+      - channel: planning_events
+        signals: [RESEARCH_COMPLETE]
+    planner:
+      - channel: planning_events
+        signals: [ROADMAP_READY, PLAN_REJECTED]
+      - channel: verification_events
+        signals: [GAPS_FOUND]
+    plan-checker:
+      - channel: planning_events
+        signals: [PLAN_READY]
+    executor:
+      - channel: execution_events
+        signals: [WAVE_STARTED]
+    verifier:
+      - channel: execution_events
+        signals: [WAVE_COMPLETE]
+      - channel: project_lifecycle
+        signals: [PHASE_COMPLETE]
+    integration-checker:
+      - channel: project_lifecycle
+        signals: [PHASE_COMPLETE]
+
+  emissions:
+    orchestrator: [PROJECT_INITIALIZED, PHASE_STARTED, WAVE_STARTED]
+    roadmapper: [ROADMAP_READY]
+    planner: [PLAN_READY]
+    plan-checker: [PLAN_VALIDATED, PLAN_REJECTED]
+    executor: [TASK_COMPLETE, WAVE_COMPLETE, CHECKPOINT_REACHED, DEVIATION_DETECTED]
+    verifier: [VERIFICATION_PASSED, GAPS_FOUND, UAT_COMPLETE]
+    project-researcher: [RESEARCH_COMPLETE]
+    phase-researcher: [RESEARCH_COMPLETE]
+    research-synthesizer: [RESEARCH_COMPLETE]
+    codebase-mapper: [RESEARCH_COMPLETE]
+    integration-checker: [INTEGRATION_VERIFIED]
+
+  routing:
+    peers:
+      # Research → Roadmap flow
+      - from: research-synthesizer
+        to: roadmapper
+        via: direct
+        signals: [RESEARCH_COMPLETE]
+      # Plan validation loop
+      - from: planner
+        to: plan-checker
+        via: direct
+        signals: [PLAN_READY]
+      - from: plan-checker
+        to: planner
+        via: direct
+        signals: [PLAN_REJECTED]
+      # Verification → Re-planning loop
+      - from: verifier
+        to: planner
+        via: direct
+        signals: [GAPS_FOUND]
+      - from: integration-checker
+        to: planner
+        via: direct
+        signals: [GAPS_FOUND]
+
+# Extension: GSD-specific workflow metadata (stored, not interpreted by openteams)
+gsd:
+  context_management:
+    description: "Each spawned agent gets fresh context. Orchestrator budgets ~15% for itself, agents get ~85%."
+    plan_budget: "50%"
+    quality_threshold: "70%"
+  execution_model:
+    type: "wave-based-parallel"
+    description: "Tasks grouped into dependency waves. Each wave's tasks run in parallel. Waves run sequentially."
+  checkpoint_protocol:
+    types: [human-verify, decision, human-action]
+    description: "Executor pauses at checkpoints, returns structured state. User responds, next executor loads state and continues."
+  commit_strategy: "atomic-per-task"
+  verification_methodology: "goal-backward"
+  workflows:
+    new_project: [project-researcher, research-synthesizer, roadmapper, verifier]
+    plan_phase: [phase-researcher, planner, plan-checker]
+    execute_phase: [executor]  # spawned in waves
+    verify_work: [verifier]
+    debug: [debugger]
+    map_codebase: [codebase-mapper]  # spawned 4x in parallel
+  state_files:
+    - PROJECT.md
+    - REQUIREMENTS.md
+    - ROADMAP.md
+    - STATE.md
+    - CONTEXT.md
+    - PLAN.md
+    - VERIFICATION.md