Commit Graph
4819 Commits
Author SHA1 Message Date
ed a758f0a4c9 feat(directives): harvest 5 directives from docs/guide_testing.md (sandbox overview, live_gui session-scoped, defer-not-catch, narrow tests, AST method visibility) 2026-07-02 23:56:26 -04:00
ed 782530ba6d feat(directives): harvest 6 directives from conductor/edit_workflow.md (Rules 1, 2, 6, 7, 8 contract-change, 8 EOL) 2026-07-02 23:56:18 -04:00
ed 8407742a14 feat(directives): harvest 2 directives from docs/AGENTS.md (core_value_read_first, convention_enforcement_4_mechanisms) 2026-07-02 23:56:11 -04:00
ed 559db09ce4 refactor(directives): strip metadata header from v1.md (45-51 of 51; meta extracted to meta.md) 2026-07-02 23:47:20 -04:00
ed 5b0f932c4b refactor(directives): strip metadata header from v1.md (36-44 of 51; meta extracted to meta.md) 2026-07-02 23:47:12 -04:00
ed 68352ee206 refactor(directives): strip metadata header from v1.md (27-35 of 51; meta extracted to meta.md) 2026-07-02 23:46:41 -04:00
ed 831499622d refactor(directives): strip metadata header from v1.md (18-26 of 51; meta extracted to meta.md) 2026-07-02 23:46:33 -04:00
ed 71e01dfee7 refactor(directives): strip metadata header from v1.md (9-17 of 51; meta extracted to meta.md) 2026-07-02 23:46:16 -04:00
ed e9a19523d6 refactor(directives): strip metadata header from v1.md (1-8 of 51; meta extracted to meta.md) 2026-07-02 23:46:04 -04:00
ed c9f30abffc docs(reports): TRACK_COMPLETION_directive_hotswap_harness_20260627 2026-07-02 23:27:25 -04:00
ed bbbfbd3947 conductor(verify): Phase 3 §3.1 directory structure verification — all 5 criteria match 2026-07-02 23:26:13 -04:00
ed 6ba4bdde48 feat(role-prompts): add 5 .warm.md duplicates (warm-with: bootstrap; originals untouched as rollback target) 2026-07-02 23:24:17 -04:00
ed 7b0d116479 feat(role-prompts): add tier2-autonomous.warm.md duplicate with warm-with: bootstrap 2026-07-02 23:23:34 -04:00
ed b2aebbc97f feat(role-prompts): add tier4-qa.warm.md duplicate with warm-with: bootstrap 2026-07-02 23:22:47 -04:00
ed 40764252f4 feat(role-prompts): add tier3-worker.warm.md duplicate with warm-with: bootstrap 2026-07-02 23:21:58 -04:00
ed b082cb158c feat(role-prompts): add tier2-tech-lead.warm.md duplicate with warm-with: bootstrap 2026-07-02 23:21:14 -04:00
ed 35831084f5 feat(role-prompts): add tier1-orchestrator.warm.md duplicate with warm-with: bootstrap 2026-07-02 23:20:07 -04:00
ed 2ddaeb52c1 feat(directives): add current_baseline preset (51 directives, all v1) 2026-07-02 23:14:36 -04:00
ed e13d8b9b8a docs(harness): Phase 2 makes .warm.md duplicates not in-place edits (per user 2026-07-02)
The 'update role prompts' step in Phase 2 was specified as in-place
edits to the 5 .opencode/agents/*.md role prompts. The user clarified
2026-07-02 that this should be making duplicates with a .warm.md
suffix so the originals stay as an explicit rollback target.

Changed:
- spec.md: added a USER DIRECTIVE block above 'The role-prompt
  bootstrap' section explaining the .warm.md duplicate convention.
- plan.md: the Phase 2 preamble references the spec directive; Steps
  2.3-2.7 rewritten as 'Create duplicate <name>.warm.md (do NOT
  modify the original)'. Output paths now include .warm.md suffix.
- dispatch_tier3_phase1.md: appended a USER DIRECTIVE section at the
  end + a NEVER-run-chronology-regenerate note (the script corrupts
  Unicode, per the 2026-07-02 revert of bfebb718).

Phase 1 work (51 v1.md directives + 11 commits ee36eaed..8162f629)
is unaffected. Master is at 068411ee (after the chronology revert).
This commit brings master to this point.
2026-07-02 22:53:27 -04:00
ed 068411ee0b Revert "docs(chronology): regenerate after directive_hotswap_harness_20260627 phase-1 commit"
This reverts commit bfebb71871.
2026-07-02 22:46:07 -04:00
ed bfebb71871 docs(chronology): regenerate after directive_hotswap_harness_20260627 phase-1 commit 2026-07-02 22:27:04 -04:00
ed 8162f629c2 conductor(plan): Mark t1_11 complete + phase_1 done (51 directives, current_phase=2) 2026-07-02 22:23:18 -04:00
ed ce0564fef6 feat(directives): commit Phase 1 harvest summary (51 v1.md files)
Systematic extraction of every directive-like statement from the entire doc tree
into conductor/directives/<name>/v1.md files. 51 v1 files lifted verbatim from
production docs.

Per-task atomic commits (t1_1..t1_10) provide the per-directive provenance.
This meta-commit captures the harvest-level summary.

Sources combed: AGENTS.md, conductor/workflow.md, conductor/product-guidelines.md,
conductor/tech-stack.md, all 14 conductor/code_styleguides/*.md,
.opencode/commands/*.md.

Original docs remain untouched as canonical source. The conductor/directives/
tree is a parallel structure, not a replacement. Future v2+ variants can
test alternative encodings (rationale-first, before/after, tabular) against
this baseline.
2026-07-02 22:21:31 -04:00
ed 9d6a30467f conductor(plan): Mark t1_10 complete 2026-07-02 22:17:57 -04:00
ed cdc0f1405c feat(directives): harvest 8 directives from feature_flags/RAG/cache/knowledge styleguides + 4 new styleguides 2026-07-02 22:17:20 -04:00
ed 09d6a9c7c8 conductor(plan): Mark t1_9 complete 2026-07-02 22:11:56 -04:00
ed fa3e5381fe feat(directives): harvest 5 GUI/architecture directives from product-guidelines.md + python.md 2026-07-02 22:11:19 -04:00
ed 2d07df594d conductor(plan): Mark t1_8 complete 2026-07-02 22:09:46 -04:00
ed 77ee0c68fd feat(directives): harvest 6 process anti-pattern directives from AGENTS.md + workflow.md 2026-07-02 22:09:05 -04:00
ed c8094ec225 conductor(plan): Mark t1_7 complete 2026-07-02 22:07:38 -04:00
ed 412494d205 feat(directives): harvest 10 process/workflow directives from AGENTS.md + workflow.md 2026-07-02 22:07:08 -04:00
ed 02320a13ea conductor(plan): Mark t1_6 complete 2026-07-02 22:03:00 -04:00
ed fa488ccfc6 feat(directives): harvest 3 file/taxonomy directives from AGENTS.md + workflow.md 2026-07-02 22:02:35 -04:00
ed 462860de54 conductor(plan): Mark t1_5 complete 2026-07-02 22:01:25 -04:00
ed b5baaaaab7 feat(directives): harvest 5 code style directives from python.md + workflow.md + product-guidelines.md + AGENTS.md 2026-07-02 22:00:37 -04:00
ed a3e587280e conductor(plan): Mark t1_4 complete 2026-07-02 21:58:09 -04:00
ed 62fc04b172 feat(directives): harvest 3 type/data-structure directives + update boundary_layer_exception 2026-07-02 21:57:36 -04:00
ed 5ba69aaa6c conductor(plan): Mark t1_3 complete 2026-07-02 21:55:22 -04:00
ed 0340925d3e feat(directives): harvest 2 directives from error_handling.md (Result pattern + nil-sentinel) 2026-07-02 21:54:48 -04:00
ed ee36eaed9a conductor(plan): Mark t1_2 complete 2026-07-02 21:52:19 -04:00
ed 545ccee118 feat(directives): harvest 3 directives from tier3-worker.md §17.9 (import/aliasing/from_dict bans) 2026-07-02 21:51:48 -04:00
ed 64485a7859 conductor(plan): Mark t1_1 complete 2026-07-02 21:50:26 -04:00
ed f4dfb84681 feat(directives): harvest 7 directives from python.md §17.1-17.7 (banned patterns + boundary exception) 2026-07-02 21:49:13 -04:00
ed 41c8678b28 conductor(track): state.toml phase 0->1 + add Tier 3 dispatch prompt for Phase 1
state.toml: current_phase 0 -> 1; phase_1.status 'pending' -> 'in_progress';
last_updated 2026-06-27 -> 2026-07-02 (matches the drift-audit batch that
updated the plan/spec).

dispatch_tier3_phase1.md: surgical prompt for the Tier 3 worker that
will execute Phase 1 (lift 48 directives verbatim from the doc tree
into conductor/directives/ per the plan). Captures the 2026-07-02 drift-
audit findings so the harvester doesn't propagate stale refs (e.g.,
the corrected audit_optional_in_3_files.py naming; the corrected §17
line ranges; the corrected send() is canonical, not send_result()).
Includes STOP-AFTER-PHASE-1 rule so Phase 2 is NOT auto-dispatched.

Per conductor/workflow.md Tier 1 Orchestrator role: this is the
maximum responsibility I (Tier 1) take in this session — actual code
generation is delegated to Tier 2/3.
2026-07-02 21:35:18 -04:00
ed fcba9e8935 Merge remote-tracking branch 'origin/master' 2026-07-02 20:53:31 -04:00
ed 6f4832b6a7 docs(skill): rewrite mma-orchestrator SKILL.md for OpenCode Task tool
The mma-orchestrator skill is what the meta-tooling Tier 1/2 agents
load. The previous version was entirely built around the deprecated
scripts/mma_exec.py / claude_mma_exec.py bridge scripts — every
example used 'uv run python scripts/mma_exec.py --role tierN-X ...'
which was deprecated 2026-06-27 in favor of the OpenCode Task tool.
Rewrote the skill to use the OpenCode Task tool's subagent_type
parameter (tier3-worker / tier4-qa / tier1-orchestrator /
tier2-tech-lead) as the canonical mechanism, with explicit
deprecation notes for mma_exec.py.

Also updated: tool count (26 -> 45, now in src/mcp_tool_specs.py);
data locations (Ticket/Track/WorkerContext now in src/mma.py; the
src/models.py shim note).

The 8 mma_exec.py invocation examples in the previous version would
have caused Tier 2 Tech Lead agents to literally invoke deprecated
scripts. This is the highest-impact drift of the session — the user
explicitly said the deprecated invocation was wrong, and this skill
is what loaded the wrong pattern into agent context.
2026-07-02 20:42:48 -04:00
ed 524bff6eb9 docs(guides): file-size drift + FileItem/ContextPreset location drift
- guide_ai_client.md: ~116KB -> ~166KB (src/ai_client.py actual size);
  '46 tools' clarified to '45 MCP tools + the PowerShell shell tool
  defined here in ai_client.py'.
- guide_gui_2.md: '~260KB, ~5400 lines' -> '~437KB, ~8970 lines
  (as of 2026-07-02)'.
- guide_context_curation.md: 'src/models.py:510 + :909' FileItem
  + ContextPreset line refs -> src/project_files.py +
  src/context_presets.py (per module_taxonomy_refactor_20260627).
2026-07-02 20:42:00 -04:00
ed 444ee13f7f docs(guides): fix vendor_capabilities.py, mma_exec.py, audit_optional_returns drift
- Readme.md AI Client row: '5 providers' -> 8; added VendorCapabilities
  inlining note + Result[str] send() API note.
- guide_ai_client.md: src/vendor_capabilities.py refs -> src/ai_client.py
  #region: Vendor Capabilities (2 sites: the capabilities param
  comment + the V2 Capability Matrix section).
- docs/AGENTS.md: audit_optional_returns.py -> audit_optional_in_3_files.py
  (the live script; the successor is not yet built).
- guide_mma.md SubConversationRunner sketch: 'Reuses mma_exec.py' ->
  'Would reuse the WorkerPool internal subprocess template (NOT the
  deprecated mma_exec.py)'.
- guide_multi_agent_conductor.md: architecture diagram box
  'Workers call mma_exec.py' -> 'Workers run via the internal
  subprocess template (run_worker_lifecycle; NOT the deprecated
  meta-tooling mma_exec.py)'; the mma_exec.py box relabeled to
  run_worker_lifecycle; See Also 'scripts/mma_exec.py — sub-agent
  entry point' -> 'src/multi_agent_conductor.py:run_worker_lifecycle
  (NOT the deprecated meta-tooling mma_exec.py)'.
2026-07-02 19:39:43 -04:00
ed 3423cc35a0 docs(workflow): fix file sizes, provider count, mma_exec deprecation in TDD section
workflow.md Architecture Fallback section still claimed gui_2 260KB,
ai_client 116KB/5 providers, mcp_client 81KB, app_controller 166KB,
multi_agent_conductor 28KB+10KB, and 'src/models.py (132KB)
centralized registry'. All updated to current sizes + the shim
reality + 8-provider count + mcp_tool_specs split + the run_worker_
lifecycle subprocess template (not mma_exec.py).

Standard Task Workflow steps 4-5 (Delegate Test Creation / Delegate
Implementation) still used the deprecated 'python scripts/mma_exec.py
--role tier3-worker' invocation as the primary example. Updated to
'OpenCode Task tool with subagent_type: tier3-worker' as the canonical
mechanism, with mma_exec noted as DEPRECATED. Same fix applied to the
Phase Completion Verification step (Tier 4 QA Agent).
2026-07-02 19:35:27 -04:00
ed 8b7b8b96c7 docs(styleguides+harness-plan): fix stale models.py refs + harness plan line drift
Styleguides:
- agent_memory_dimensions.md: FileItem/ContextPreset line refs
  (src/models.py:510-559 / 909-937) -> src/project_files.py +
  src/context_presets.py (moved per module_taxonomy_refactor_20260627).
- config_state_owner.md: 'file I/O primitives in src/models.py' ->
  src/project_manager.py (the config-load/save helpers moved).
- python.md §10 NOT-exempt list: '12 per-aggregate types' -> ~19;
  'dataclass types in src/models.py' -> per-system files enumeration
  (mma.py, project_files.py, mcp_tool_specs.py, result_types.py,
  personas.py, workspace_manager.py, mcp_client.py).
- type_aliases.md: type-registry lookup examples updated to the
  per-system files (src_mma.md, src_project_files.md, etc.); the
  'src/models.py: 48 dataclass field types' worked-example line is
  flagged as historical (pre-refactor state).

Harness plan (directive_hotswap_harness_20260627/plan.md):
- §17 line refs corrected: 17.1 220-237 -> 247-264; 17.2 239-250 ->
  266-277; 17.3 252-272 -> 279-299; 17.4 274-299 -> 301-326; 17.5
  301-311 -> 328-338; 17.6 313-323 -> 340-350; 17.7 325-327 ->
  352-354; 17.9 336-409 -> 364-443.
- §17 master range 216-409 -> 243-473.
- §12 175-184 -> 202-211; §13 185-199 -> 212-224; §15 205-215 ->
  234-241.
- error_handling.md: hard rules 212-242 -> 212-264; boundary types
  274-311 -> 284-365.
- type_aliases.md: 40-81 -> 13-87 + 89-160 + 284-365 (the alias
  table + decision pattern 2.5 + boundary/anti-pattern sections).
2026-07-02 19:31:32 -04:00