omniconductor 0.3.0

package/adapters/gemini/README.md

@@ -0,0 +1,93 @@
+# Adapter — Gemini CLI (T2)
+
+Gemini CLI is a T2 target because:
+
+- It supports a single always-loaded rule file (`GEMINI.md`).
+- It supports a coding-style guide convention (`.gemini/styleguide.md`).
+- It excels at large-context exploration — the always-loaded rule bundle fits its strengths.
+
+It is **T2** because:
+
+- ❌ No per-pattern rule scoping (single-file bundle).
+- ❌ No sub-agent dispatch.
+- ❌ No hooks.
+- ❌ No per-call model routing.
+- ❌ No built-in memory directory.
+
+**Tier**: T2 — Good for large-context use; rule scoping is "all rules always-loaded".
+
+## Installation path
+
+```bash
+# From the conductor repo root:
+bash adapters/gemini/transform.sh <target-project>
+
+# With opt-in recipes (coding-conventions also emits .gemini/styleguide.md):
+bash adapters/gemini/transform.sh <target-project> --recipes=coding-conventions,i18n
+
+# CI-safe (no interactive prompts) / preview / revert:
+bash adapters/gemini/transform.sh <target-project> --no-prompt
+bash adapters/gemini/transform.sh <target-project> --dry-run
+bash adapters/gemini/transform.sh <target-project> --uninstall
+```
+
+## What gets installed
+
+```
+<target>/
+├── GEMINI.md                                   # All universal rules concatenated, sectioned
+├── .gemini/
+│   └── styleguide.md                           # coding-conventions excerpt (Gemini convention)
+└── docs/
+    ├── CURRENT_WORK.md                         # Universal templates
+    ├── REMAINING_TASKS.md
+    ├── PLANS.md
+    ├── TASKS.md
+    ├── INDEX.md
+    └── specs/_example.md
+```
+
+## Native features supported
+
+- ✅ Always-loaded baseline (`GEMINI.md`).
+- ✅ Style guide convention (`.gemini/styleguide.md`).
+- ✅ All universal rule TEXT (concatenated).
+- ✅ All doc templates.
+- ✅ Strong large-context capability — the bundled rule file is fine to load every session.
+
+## Features NOT supported
+
+| Feature | Workaround |
+|---|---|
+| Per-pattern rule scoping | All rules always-loaded; no per-file routing. Rule TEXT is the same; you just see all of it always. |
+| Sub-agent dispatch | Human plays orchestrator. |
+| Hooks | Pair with project pre-commit git hooks. |
+| Per-call model routing | Single model per session. |
+| Built-in memory directory | DIY at `.memory/`. |
+
+## After install — first steps
+
+1. Verify Gemini CLI reads `GEMINI.md` on session start (it should — that's the convention).
+2. Customize the always-loaded section of `GEMINI.md` — replace `{{PROJECT_NAME}}`.
+3. Rename `docs/specs/_example.md` → `docs/specs/<your-area>.md`.
+4. Add `.memory/` to `.gitignore`.
+5. Add your first entry to `docs/CURRENT_WORK.md`.
+
+## Best fit use cases
+
+- Large-context exploration ("read this 10K-line file and summarize").
+- One-off scripts where the orchestrator pattern is overkill.
+- Cheap second-opinion when the primary tool is Claude or Cursor.
+
+## Quirks / known issues (P3 will fill)
+
+- TBD: Gemini CLI's exact file-discovery behavior (does it walk parent directories looking for `GEMINI.md`?).
+- TBD: `.gemini/styleguide.md` priority vs `GEMINI.md` when both contain conflicting rules.
+
+## Status (P0 foundation)
+
+- ✅ `README.md`
+- ✅ `SUPPORTED-FEATURES.md`
+- ✅ `transform-spec.md`
+- ✅ `transform.sh` (implemented)
+- ⏳ `notes.md` (P3)

package/adapters/gemini/SUPPORTED-FEATURES.md

@@ -0,0 +1,80 @@
+# Gemini CLI — supported features
+
+Detailed matrix of which CONDUCTOR features Gemini CLI supports.
+
+## Feature support
+
+| Feature | Gemini support | Mechanism | Notes |
+|---|---|---|---|
+| **Always-loaded baseline** | ✅ Native | `GEMINI.md` at project root | Auto-loaded by Gemini CLI on session start. |
+| **Style guide convention** | ✅ Native | `.gemini/styleguide.md` | Coding-style-specific guide; complements GEMINI.md. |
+| **Large-context capability** | ✅ Strength | Up to ~1M-2M tokens depending on Gemini Pro version | Bundled rule loading is no problem. |
+| **Per-pattern rule scoping** | ❌ | — | All rules always-loaded. No per-file routing. |
+| **Sub-agent dispatch** | ✅ Native (2026) | Custom named agents in `.gemini/agents/*.md` | See `docs/COMPATIBILITY-MATRIX.md` / ADR-031. |
+| **Hooks (SessionEnd etc.)** | ✅ Native (2026) | `hooks` block in `.gemini/settings.json` | ADR-031. CONDUCTOR currently emits only the Reflector hook (ADR-032); broader hook-set emission is Phase 2. |
+| **Per-task model routing** | ✅ Native (2026) | Per-agent model config | ADR-031. |
+| **Custom slash commands** | ✅ Native (2026) | `.gemini/commands/*.toml` | ADR-031. |
+| **Built-in memory directory** | ❌ | — | DIY at `.memory/`. |
+| **In-repo doc templates** | ✅ Universal | Plain markdown | Gemini reads on demand. |
+| **Spec-as-you-go ABSOLUTE enforcement** | ❌ rule reminder only | Rule text in `GEMINI.md` reminds user | Self-policed. |
+| **Two-stage code review enforcement** | ❌ rule reminder only | | |
+
+## Universal-rule → Gemini bundle translation
+
+For each `core/universal-rules/<rule>.md`:
+
+1. Strip front-matter (Gemini doesn't use it).
+2. Concatenate body content into `GEMINI.md` as a section with heading `## <rule name>`.
+3. Tool-specific callouts:
+   - `> **Gemini-only mechanism**` callouts (rare): keep.
+   - `> **Claude-only mechanism**` callouts: REPLACE with `> **Note (Gemini)**: enforced by hook on Claude Code; on Gemini CLI, follow self-policed.`
+   - Other tool callouts: STRIP.
+
+## `.gemini/styleguide.md` content
+
+Specifically the coding-conventions rule's body, formatted as a Gemini styleguide. Use Google's published styleguide format as inspiration if Gemini documents one.
+
+## What Gemini DOES NOT support
+
+> **2026 reconciliation (first-party verified):** most limitations previously listed here are stale. Gemini CLI now natively supports hooks (via `.gemini/settings.json`, e.g. `SessionEnd`), sub-agent dispatch with custom named agents (`.gemini/agents/*.md`), per-task model routing, and custom commands (`.gemini/commands/*.toml`) — see `docs/COMPATIBILITY-MATRIX.md` / ADR-031.
+
+Still true:
+
+- Per-pattern rule scoping (everything is always-loaded — no per-file routing).
+- No built-in memory directory — DIY at `.memory/`.
+- No native scheduler.
+- CONDUCTOR does not yet emit a Claude-parity hook set for Gemini. It currently emits only the self-improvement Reflector hook (ADR-032, opt-in — see below); broader hook-set emission (commit-blocking, spec enforcement) is Phase 2.
+
+## Strengths to lean into
+
+- Large context — loading the entire bundled `GEMINI.md` is cheap on Gemini Pro models.
+- Use Gemini for "read everything, then answer" workflows where bundled rules are an asset, not a cost.
+
+## Self-improvement (Reflector) — opt-in
+
+With `--recipes=self-improvement`, the Gemini adapter emits the Reflector loop (ADR-032):
+
+- **Hook**: `.gemini/settings.json` — registers `.conductor/reflect/trajectory-log.sh` on the `SessionEnd` event. Written only if no settings/hook config exists; if one is already present, the adapter emits a manual-merge log entry instead of overwriting.
+- **Command**: `.gemini/commands/reflect.toml` — the `/reflect` command that distills the trajectory log into lesson candidates.
+- **Agent**: `.gemini/agents/reflector.md` — named reflector agent for the distillation pass.
+- **Scripts**: `.conductor/reflect/trajectory-log.sh` (session trajectory capture) and `.conductor/reflect/prune-lessons.sh` (lesson-file size pruning).
+
+The loop is propose-only — lessons are proposed for human review, never auto-applied to rules. The hook no-ops unless `.conductor/reflect/` exists, so installs without the recipe are unaffected (opt-in gate).
+
+## Verification
+
+`adapters/gemini/transform.sh` is **implemented**. The adapter emits, on a real
+install, `GEMINI.md` (5 universal rules + compressed workflow + ABSOLUTE summary +
+docs pointer + DIY `.memory/` note), the opt-in `.gemini/styleguide.md` (when
+`--recipes=coding-conventions`), the `docs/*` templates, and a
+`.conductor-manifest.json` (supports `--uninstall`). Flags: `--recipes=`,
+`--dry-run`, `--no-prompt`, `--uninstall`/`--force`, `--help`.
+
+The two runtime-citation checks below still require a live Gemini CLI session
+(whether the model actually cites the loaded files), so they remain observed-only:
+
+| Feature claim | Verified-by-real-install | Verification command / observation |
+|---|---|---|
+| Adapter emits `GEMINI.md` + `.gemini/styleguide.md` + `docs/*` | ✅ implemented | `bash adapters/gemini/transform.sh <target> --no-prompt --recipes=coding-conventions` then inspect the tree. |
+| `GEMINI.md` auto-loads on session start | ⏳ live session | Open project with Gemini CLI; verify it cites `GEMINI.md` content. |
+| `.gemini/styleguide.md` auto-loads | ⏳ live session | Ask Gemini for code-style guidance; verify styleguide cited. |

package/adapters/gemini/transform-spec.md

@@ -0,0 +1,102 @@
+# Gemini CLI adapter — transform.sh specification
+
+What `adapters/gemini/transform.sh` MUST do when implemented in P3.
+
+## Invocation
+
+```bash
+./transform.sh <target-dir> [--dry-run]
+```
+
+## Inputs
+
+```
+core/universal-rules/meta-discipline.md
+core/universal-rules/operations.md
+core/universal-rules/quality-gates.md
+core/universal-rules/spec-as-you-go.md
+core/universal-rules/workflow.md
+core/docs-templates/*.md
+core/docs-templates/specs/_example.md
+core/memory-pattern/README.md
+adapters/gemini/_native/GEMINI.md.tpl              # Header template (orchestrator manual intro for Gemini)
+```
+
+## Outputs
+
+```
+<target-dir>/
+├── GEMINI.md                                   # Bundled all-rules + orchestrator manual + universal rule TEXT
+├── .gemini/
+│   └── styleguide.md                           # coding-conventions recipe excerpt (opt-in)
+└── docs/
+    ├── CURRENT_WORK.md                         # Verbatim
+    ├── REMAINING_TASKS.md
+    ├── PLANS.md
+    ├── TASKS.md
+    ├── INDEX.md
+    └── specs/_example.md
+```
+
+## `GEMINI.md` composition (in order)
+
+1. **Header from `_native/GEMINI.md.tpl`** — bilingual (한/영) "you are the orchestrator" intro adapted for Gemini single-session model.
+2. **ABSOLUTE rules section** — R1-R8 minus Claude-only sub-agent enforcement. R-prefix renumbered for Gemini reality.
+3. **Universal rules section** — for each `core/universal-rules/<rule>.md`:
+   - Heading: `## <rule title>`
+   - Body: rule content sans front-matter.
+4. **Workflow section** — content from `core/workflow/PHASES.md`, slightly compressed for size.
+5. **Pointer to docs** — `Read docs/CURRENT_WORK.md first every session.`
+6. **Note on memory** — explain DIY `.memory/` setup (since Gemini has no built-in directory).
+
+## `.gemini/styleguide.md` composition
+
+- Body of `core/recipes/coding-conventions.md` (sans front-matter; opt-in recipe).
+- Header: `# Code style guide for <project>` (with `{{PROJECT_NAME}}` placeholder for user to fill).
+
+## Universal-rules → Gemini bundle translation
+
+For each `core/universal-rules/<rule>.md`:
+
+1. Strip front-matter (Gemini doesn't use front-matter).
+2. Concatenate body into `GEMINI.md` as documented above.
+3. Tool-specific callouts:
+   - `> **Gemini-only mechanism**`: keep as-is (rare).
+   - `> **Claude-only mechanism**`: REPLACE with `> **Note (Gemini)**: enforced by hook on Claude Code; on Gemini CLI, follow self-policed.`
+   - Other tool callouts: STRIP.
+
+## Edge cases
+
+| Case | Adapter behavior |
+|---|---|
+| Existing `GEMINI.md` at target | Skip; report "SKIP (exists)". |
+| Existing `.gemini/styleguide.md` | Skip individually. |
+| `GEMINI.md` would exceed Gemini context limit | Warn (and document mitigation in `notes.md`). |
+
+## Idempotency check
+
+Re-run reports "SKIP (exists)" for everything.
+
+## Verification commands (P3 will fill)
+
+```bash
+test -f "<target>/GEMINI.md"                           || echo "MISSING GEMINI.md"
+test -f "<target>/.gemini/styleguide.md"               || echo "MISSING styleguide"
+
+# Open Gemini CLI in <target>; verify it cites GEMINI.md content in responses.
+# Ask Gemini for code-style guidance; verify .gemini/styleguide.md is consulted.
+```
+
+## P3 Gemini version compatibility check
+
+Verify against current Gemini CLI conventions:
+- `GEMINI.md` IS the canonical project-rules file.
+- `.gemini/styleguide.md` IS the canonical style-guide convention.
+- Whether Gemini walks parent directories for `GEMINI.md` (mono-repo implication).
+
+If Gemini has changed conventions by P3, document in `notes.md`.
+
+## Out of scope
+
+- Gemini API key configuration (user does this in Gemini CLI auth flow).
+- Per-stack auto-detection.