Files

Michael Chihlas bee8690056 chore(ai): migrate to dual-agent handoff system

Split the monolithic CLAUDE.md into a durable handoff system:

- .ai/PROJECT_CONTEXT.md  — stable architectural truth (stack, structure,
  SaaS shape, ConnectWise, coding standards, frontend patterns, critical
  lessons). Ported verbatim from the previous CLAUDE.md.
- .ai/CURRENT_TASK.md     — single active task with DoD + out-of-scope.
- .ai/HANDOFF.md          — resume point, kept under ~2K tokens.
- .ai/TODO.md             — backlog, read only when CURRENT_TASK complete.
- .ai/DECISIONS.md        — append-only architectural decision log.
- .ai/SESSION_LOG.md      — append-only chronological history.
- .ai/README.md           — human-facing explanation of the system.

Root agent files share a byte-identical protocol block (verified via diff):

- CLAUDE.md — primary agent, with GitNexus + gstack tooling and the
  Claude Opus 4.7 co-author trailer.
- AGENTS.md — OpenAI Codex resume agent, with grep/rg fallbacks and the
  Codex co-author trailer. Steps in when Claude hits session/weekly
  limits.

Legacy root-level SESSION-HANDOFF.md deleted — superseded by .ai/HANDOFF.md.
It was a self-describing one-off from the Design System v4 migration and
had no external references.

Supersedes previous CLAUDE.md. Old version recoverable via
`git show pre-ai-handoff:CLAUDE.md` (tag points at commit e110fed).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-04-24 14:50:41 -04:00

888 B

Raw Blame History

SESSION_LOG.md

Append-only chronological record. Newest entries at the top. Skim when broader context is needed. Entry format:
## YYYY-MM-DD HH:MM <timezone> — <agent> — <one-line summary>
- What was accomplished
- What was left for next session
- Files touched

2026-04-24 — Claude Code — Migrate to dual-agent handoff system

Split CLAUDE.md into .ai/PROJECT_CONTEXT.md + shared-protocol root files (CLAUDE.md, AGENTS.md).
Seeded CURRENT_TASK.md, HANDOFF.md, TODO.md, DECISIONS.md, SESSION_LOG.md, README.md.
Deleted legacy SESSION-HANDOFF.md (superseded).
Left for next session: first real feature task should replace the seed CURRENT_TASK.md and update HANDOFF.md with real resume state.
Files touched: .ai/*.md (created), CLAUDE.md (rewritten), AGENTS.md (created), SESSION-HANDOFF.md (deleted).

888 B Raw Blame History

SESSION_LOG.md

2026-04-24 — Claude Code — Migrate to dual-agent handoff system

888 B

Raw Blame History