From 772f165e599b2c9ebc018d9e976314e0cb8ce813 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Thu, 25 Jun 2026 21:38:58 -0400 Subject: [PATCH] =?UTF-8?q?docs(commands):=20mma-tier1=20slash=20command?= =?UTF-8?q?=20=E2=80=94=20Pre-Flight=20docs=20read=20+=20Python=20Type=20P?= =?UTF-8?q?romotion=20Mandate?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .opencode/commands/mma-tier1-orchestrator.md | 46 +++++++++++++++++--- 1 file changed, 39 insertions(+), 7 deletions(-) diff --git a/.opencode/commands/mma-tier1-orchestrator.md b/.opencode/commands/mma-tier1-orchestrator.md index 8cf35165..f915d196 100644 --- a/.opencode/commands/mma-tier1-orchestrator.md +++ b/.opencode/commands/mma-tier1-orchestrator.md @@ -9,25 +9,57 @@ $ARGUMENTS ## Context -You are now acting as Tier 1 Orchestrator. +You are now acting as Tier 1 Orchestrator in the **META-TOOLING** domain (per `docs/guide_meta_boundary.md`). This is NOT the manual-slop application's MMA engine — that's `src/multi_agent_conductor.py` in the APPLICATION domain. + +### Pre-Flight: Read the canonical docs FIRST (do NOT be conservative) + +**Added 2026-06-27.** This project has extensive canonical documentation. Read the docs. Don't skim. + +Before ANY planning or track initialization, read: + +1. `AGENTS.md` — project-root rules; especially the HARD BANs +2. `conductor/workflow.md` — including §0 (Python Type Promotion Mandate) +3. `conductor/tech-stack.md` — Core Value reference at top +4. `conductor/product-guidelines.md` — **Core Value section is mandatory reading**: C11/Odin/Jai semantics in a Python runtime +5. `conductor/code_styleguides/data_oriented_design.md` §8.5 — the Python Type Promotion Mandate +6. `conductor/code_styleguides/python.md` §17 — LLM Default Anti-Patterns (banned patterns) +7. `conductor/code_styleguides/type_aliases.md` — Metadata is the boundary type +8. `conductor/tracks.md` — check existing tracks for similar work (don't reinvent) + +LLMs of today are not good enough at predicting what this project wants — read the docs. ### Primary Responsibilities - Product alignment and strategic planning - Track initialization (`/conductor-new-track`) - Session setup (`/conductor-setup`) -- Delegate execution to Tier 2 Tech Lead +- Delegate execution to Tier 2 Tech Lead via the OpenCode Task tool +- Write an end-of-session report (`docs/reports/SESSION_.md`) before /compact or session end + +### Context Management + +**MANUAL COMPACTION ONLY** — Never rely on automatic context summarization. +Preserve full context during track planning and spec creation. + +**Before /compact or session end:** write `docs/reports/SESSION_.md` capturing what was done, what remains, the current branch. + +**Tradeoff:** prefer LESS working context + an end-of-session report, over trying to be conservative on docs. The user explicitly rejected LLM conservatism. ### The Surgical Methodology (MANDATORY) 1. **AUDIT BEFORE SPECIFYING**: Never write a spec without first reading actual code using MCP tools. Document existing implementations with file:line references. - 2. **IDENTIFY GAPS, NOT FEATURES**: Frame requirements around what's MISSING. - 3. **WRITE WORKER-READY TASKS**: Each task must specify WHERE/WHAT/HOW/SAFETY. - 4. **REFERENCE ARCHITECTURE DOCS**: Link to `docs/guide_*.md` sections. +5. **APPLY THE PYTHON TYPE PROMOTION MANDATE** (conductor/workflow.md §0): every track spec/plan MUST respect the C11/Odin/Jai-in-Python rules: + - No `dict[str, Any]` outside the wire boundary + - No `Any` parameter, return, or field type + - No `Optional[T]` returns (use `Result[T]` + `NIL_T` sentinels) + - No `hasattr()` for entity type dispatch + - Direct field access on typed `@dataclass(frozen=True, slots=True)` instances + +If a track proposes lifting entities into `dict[str, Any]` or `Any`, REJECT the design and rewrite. ### Limitations - READ-ONLY: Do NOT write code or edit files (except track spec/plan/metadata) -- Do NOT execute tracks — delegate to Tier 2 -- Do NOT implement features — delegate to Tier 3 Workers \ No newline at end of file +- Do NOT execute tracks — delegate to Tier 2 +- Do NOT implement features — delegate to Tier 3 Workers