From 4a74487e0666d43482c794711e061494ced1ed76 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Wed, 25 Feb 2026 08:38:52 -0500 Subject: [PATCH] chore(conductor): Add new track 'MMA Tiered Architecture Verification' --- conductor/tracks.md | 5 ++++ .../tracks/mma_verification_20260225/index.md | 5 ++++ .../mma_verification_20260225/metadata.json | 8 ++++++ .../tracks/mma_verification_20260225/plan.md | 26 +++++++++++++++++ .../tracks/mma_verification_20260225/spec.md | 28 +++++++++++++++++++ 5 files changed, 72 insertions(+) create mode 100644 conductor/tracks/mma_verification_20260225/index.md create mode 100644 conductor/tracks/mma_verification_20260225/metadata.json create mode 100644 conductor/tracks/mma_verification_20260225/plan.md create mode 100644 conductor/tracks/mma_verification_20260225/spec.md diff --git a/conductor/tracks.md b/conductor/tracks.md index fc7d048..ddfa59f 100644 --- a/conductor/tracks.md +++ b/conductor/tracks.md @@ -37,3 +37,8 @@ This file tracks all major tracks for the project. Each track has its own detail - [ ] **Track: Support gemini cli headless as an alternative to the raw client_api route. So that they user may use their gemini subscription and gemini cli features within manual slop for a more discliplined and visually enriched UX.** *Link: [./tracks/gemini_cli_headless_20260224/](./tracks/gemini_cli_headless_20260224/)* + +--- + +- [ ] **Track: MMA Tiered Architecture Verification** +*Link: [./tracks/mma_verification_20260225/](./tracks/mma_verification_20260225/)* diff --git a/conductor/tracks/mma_verification_20260225/index.md b/conductor/tracks/mma_verification_20260225/index.md new file mode 100644 index 0000000..586051b --- /dev/null +++ b/conductor/tracks/mma_verification_20260225/index.md @@ -0,0 +1,5 @@ +# Track mma_verification_20260225 Context + +- [Specification](./spec.md) +- [Implementation Plan](./plan.md) +- [Metadata](./metadata.json) \ No newline at end of file diff --git a/conductor/tracks/mma_verification_20260225/metadata.json b/conductor/tracks/mma_verification_20260225/metadata.json new file mode 100644 index 0000000..969eb58 --- /dev/null +++ b/conductor/tracks/mma_verification_20260225/metadata.json @@ -0,0 +1,8 @@ +{ + "track_id": "mma_verification_20260225", + "type": "feature", + "status": "new", + "created_at": "2026-02-25T08:37:00Z", + "updated_at": "2026-02-25T08:37:00Z", + "description": "MMA Tiered Architecture Verification" +} \ No newline at end of file diff --git a/conductor/tracks/mma_verification_20260225/plan.md b/conductor/tracks/mma_verification_20260225/plan.md new file mode 100644 index 0000000..57839aa --- /dev/null +++ b/conductor/tracks/mma_verification_20260225/plan.md @@ -0,0 +1,26 @@ +# Implementation Plan: MMA Tiered Architecture Verification + +## Phase 1: Research and Investigation +- [ ] Task: Review `mma-orchestrator/SKILL.md` and `MMA_Support` docs for Tier 2/3/4 definitions. +- [ ] Task: Investigate "Centralized Skill" vs. "Role-Based Sub-Agents" architectures for hierarchical delegation. +- [ ] Task: Define the recommended architecture for sub-agent roles and their invocation protocol. +- [ ] Task: Conductor - User Manual Verification 'Research and Investigation' (Protocol in workflow.md) + +## Phase 2: Infrastructure Verification +- [ ] Task: Write tests for `.\scripts un_subagent.ps1` to ensure it correctly spawns stateless agents and handles output. +- [ ] Task: Verify `run_subagent.ps1` behavior for Tier 3 (coding) and Tier 4 (QA) use cases. +- [ ] Task: Create a diagnostic test to verify Tier 2 -> Tier 3 delegation flow and context isolation. +- [ ] Task: Conductor - User Manual Verification 'Infrastructure Verification' (Protocol in workflow.md) + +## Phase 3: Test Track Implementation +- [ ] Task: Scaffold the `mma_verification_mock` test track directory and metadata. +- [ ] Task: Draft `spec.md` and `plan.md` for the mock track, explicitly including tiered delegation steps. +- [ ] Task: Execute the mock track using `/conductor:implement` (simulated or real). +- [ ] Task: Verify the requirement "Tier 3 can spawn Tier 4" within the mock track's implementation flow. +- [ ] Task: Conductor - User Manual Verification 'Test Track Implementation' (Protocol in workflow.md) + +## Phase 4: Final Validation and Reporting +- [ ] Task: Run the full suite of automated verification tests for the tiered architecture. +- [ ] Task: Collect and analyze logs from the mock track execution to confirm traceability and token firewalling. +- [ ] Task: Produce the final analysis report and architectural recommendation for MMA. +- [ ] Task: Conductor - User Manual Verification 'Final Validation and Reporting' (Protocol in workflow.md) diff --git a/conductor/tracks/mma_verification_20260225/spec.md b/conductor/tracks/mma_verification_20260225/spec.md new file mode 100644 index 0000000..d42e29a --- /dev/null +++ b/conductor/tracks/mma_verification_20260225/spec.md @@ -0,0 +1,28 @@ +# Specification: MMA Tiered Architecture Verification + +## Overview +This track aims to review and verify the implementation of the 4-Tier Hierarchical Multi-Model Architecture (MMA) within the Conductor framework. It will confirm that Conductor operates as a Tier 2 Tech Lead/Orchestrator and can successfully delegate tasks to Tier 3 (Workers) and Tier 4 (QA/Utility) sub-agents. A key part of this track is investigating whether this hierarchy should be enforced via a single centralized skill or through separate role-based sub-agent definitions. + +## Functional Requirements +1. **Skill Review:** Analyze `mma-orchestrator/SKILL.md` and `MMA_Support` docs to ensure they correctly mandate Tier 2 behavior for Conductor. +2. **Delegation Verification:** + - Verify Conductor (Tier 2) can spawn Tier 3 sub-agents for heavy coding tasks using `.\scripts un_subagent.ps1`. + - Verify Tier 3/4 sub-agents can be spawned for error analysis/compression. +3. **Architectural Investigation:** Evaluate the pros/cons of a centralized `mma-orchestrator` skill vs. independent role-based sub-agents. Determine the best way to define sub-agent roles. +4. **Test Track Creation:** Implement a "Mock Implementation" track that demonstrates the full tiered delegation flow (Tier 2 -> Tier 3 -> Tier 4). +5. **Automated Testing:** Create `pytest` cases to verify the IPC and script execution flow of the tiered sub-agents. + +## Non-Functional Requirements +- **Traceability:** All sub-agent invocations must be clearly logged in the session. +- **Context Efficiency:** Ensure sub-agent delegation effectively prevents token bloat in the main Conductor context. + +## Acceptance Criteria +- [ ] Analysis report comparing centralized skill vs. role-based sub-agents. +- [ ] A functional test track (`mma_verification_mock`) that executes a full tiered delegation sequence. +- [ ] Traceable logs confirming sub-agent spawning and task completion. +- [ ] Pytest suite verifying the sub-agent infrastructure and interaction logic. +- [ ] Plan alignment: The test track's `plan.md` explicitly includes delegation steps. + +## Out of Scope +- Implementing a full production-ready multi-model backend. +- Modifying the core `gemini-cli` binary.