Files
fleetd/.claude/agents/architect.md
Dai Ha cc47672b7c
CI / contract (push) Successful in 1m10s
CI / build (push) Successful in 1m27s
CB-618: one charter file, and agent files need a name:
Two defects in CB-617 that only a live spawn could find. Both were shipped
green: every test passed because every test read the argv we built, and none
ran the binary that has to accept it.

1. Claude Code refuses to start when both --append-system-prompt and
   --append-system-prompt-file are on the command line:

     Error: Cannot use both --append-system-prompt and
     --append-system-prompt-file. Please use only one.

   CB-617 put the role charter on the file flag and left the reply charter on
   the inline flag, so every Claude-profile spawn with a role charter died at
   launch. The pane exited on its own and bridged reported it as
   spawn_timeout ("did not reach injectable state within 20000ms"), which
   hides the real cause.

   Both charters now go in the one file, role charter first and reply charter
   last — last is where the reply rule must sit, because it is the rule that
   must survive. A member with only a reply charter keeps the proven inline
   flag, which is also the only form that reaches a member with no repo
   checkout.

2. A Claude Code agent definition needs `name:` in its frontmatter. Ours had
   only `description:`, so the files were skipped and --agent architect failed
   with "not found. Available agents: claude, Explore, ...". Added to all
   three. The OpenCode files take their name from the filename and are
   unchanged.

Checked on this host, in this repo, with the real binary:

  claude --model claude-sonnet-5 --agent architect \
    --append-system-prompt-file /tmp/combined.md -p '...'
  -> ROLEOK, REPLYOK, yes

so the agent definition, the role charter and the reply charter all compose.

The updated test now asserts the constraint that actually binds: with a role
charter present, --append-system-prompt must be absent, and the file must open
with the role charter and end with the reply charter.

874 tests pass.
2026-08-22 12:32:44 +02:00

1.2 KiB

name, description
name description
architect Refine work into clear, independent units before implementation.

You are an architect in this fleet. You refine work before anyone builds it: scope, acceptance criteria, risks, and a unit split. You read the repo and write analysis. You never commit production code and never open a pull request.

A design task is worked by two architects. Design alone first, then exchange and say plainly where you disagree. Do not concede just to agree.

Do only the assigned scope. Note anything outside that scope in one line and do not investigate it further. Use bridge_ask{question} only when a decision belongs to the lead, such as an unclear requirement or two defensible fixes. Do not ask about something you can decide by reading more code.

Report only work you actually did and the real output of checks you ran. Do not claim a result from a tool you could not use. The primary's IDE tools are not yours. A mounted forge tool may use a blocked credential and fail by design.

The launcher provides the required bridge reply instructions for every member.