AGENTS.md

1---
2name: sisyphus-variants
3description: Developer reference for Sisyphus orchestrator model-specific prompt variants — selection logic and key exports.
4---
5 
6# src/agents/sisyphus/ -- Orchestrator Variants
7 
8**Generated:** 2026-07-17
9 
10## OVERVIEW
11 
12Model-specific prompt variants for the Sisyphus main orchestrator. Parent `sisyphus-agent-factory.ts` routes to the correct variant based on active model.
13 
14## FILES
15 
16| File | Purpose |
17|------|---------|
18| `default.ts` | Base/Claude variant: task management, delegation guides, 542 LOC |
19| `claude-opus-4-7.ts` | Opus 4.7-native: literal-instruction tuning, bounded exploration/thinking |
20| `claude-opus-4-8.ts` | Opus 4.8-native: silence-default narration, small-decision autonomy, bounded exploration |
21| `claude-opus-5.ts` | Opus 5-native: scope constraint, delegation cap, over-verification removal, narration cadence |
22| `claude-fable-5.ts` | Fable 5-native: top-tier model, Opus 4.8 tuning direction |
23| `gemini.ts` | Gemini-optimized: stricter tool-usage rules, 5 NEVER rules |
24| `gpt-5-4.ts` | GPT-5.4-native: 8-block architecture, entropy-reduced, 449 LOC |
25| `gpt-5-5.ts` | Shared GPT-5.5/GPT-5.6 model-aware orchestration prompt |
26| `gpt-task-system-guide.ts` | Tracking-tool guide shared by the GPT-5.5/GPT-5.6 prompt family |
27| `glm-5-2.ts` | GLM-5.2-native variant with explicit failure-mode calibration |
28| `kimi-k2-6.ts` | Kimi K2.6-native variant |
29| `kimi-k2-7.ts` | Kimi K2.7-native variant |
30| `kimi-k3.ts` | Kimi K3-native variant with explicit anti-overthinking calibration |
31| `index.ts` | Barrel exports |
32 
33## VARIANT SELECTION
34 
35`sisyphus-agent-factory.ts` selects variant by model name:
36- Kimi K3 -> `kimi-k3.ts`
37- Kimi K2.7 -> `kimi-k2-7.ts`
38- Kimi K2 family -> `kimi-k2-6.ts`
39- Contains "gpt-5.5" or "gpt-5.6" -> shared `gpt-5-5.ts` prompt family with model-aware identity
40- GPT-5.4+ -> `gpt-5-4.ts`
41- Contains "claude-fable-5" -> `claude-fable-5.ts`
42- Contains "claude-opus-5" -> `claude-opus-5.ts`
43- Contains "claude-opus-4-8" -> `claude-opus-4-8.ts`
44- Contains "claude-opus-4-7" -> `claude-opus-4-7.ts`
45- GLM family -> `glm-5-2.ts`
46- Default -> fallback prompt (Claude, etc.; Gemini gets corrective overlays)
47 
48## KEY EXPORTS
49 
50Each variant exports:
51- `buildTaskManagementSection()` -- todo/task management prompt
52- `buildSisyphusPrompt()` or equivalent -- full prompt builder
53