execute

Execute: Implement an Archon Plan

Objective

Read and execute every task in the plan file: $ARGUMENTS

Implement all tasks faithfully, following Archon monorepo conventions, and report results.

---

Step 1: Read the Entire Plan

Read the plan file at $ARGUMENTS from start to finish before writing a single line of code. Understand:

• All tasks and their dependencies
• Affected packages and files
• Architecture notes and prohibited patterns
• The validation steps at the end

Do NOT start implementing until you have the full picture.

---

Step 2: Verify Current State

Check the working tree is clean before starting:

git status

If there are uncommitted changes unrelated to this plan, flag them before proceeding.

Check the current branch:

git branch --show-current

---

Step 3: Execute Tasks in Dependency Order

Work through each task in the plan sequentially (respecting Depends on: ordering).

For each task:

1. Read the target file(s) before modifying — never edit blindly.
2. Implement the change using the Edit or Write tools.
3. Verify the change compiles after touching TypeScript files:

   bun run type-check 2>&1 | tail -20
   

   Fix type errors immediately — do not accumulate them.

Archon conventions to follow:

Imports:

// Type-only imports
import type { IPlatformAdapter, Conversation } from '@archon/core';
// Value imports — named, not namespace
import { handleMessage, pool } from '@archon/core';
// Submodule namespace imports (acceptable)
import * as git from '@archon/git';

Functions:

// All functions need explicit return types
async function createSession(id: string): Promise<Session> { ... }
// No implicit any

Logging:

import { createLogger } from '@archon/paths';
// Lazy logger pattern (test mocks work correctly)
let cachedLog: ReturnType<typeof createLogger> | undefined;
function getLog(): ReturnType<typeof createLogger> {
  if (!cachedLog) cachedLog = createLogger('my-module');
  return cachedLog;
}
// Event naming: {domain}.{action}_{state}
log.info({ id }, 'session.create_started');