Expand description
Prompt construction.
These strings are the actual product. The graph only moves bytes around; how well a run goes is decided by what the judges are asked to look at and what they are forbidden to speculate about.
Two rules run through all of them:
- No authorship. Nothing an agent receives names a model or a vendor, and every prompt that could invite a guess explicitly forbids guessing.
- Checkable claims. Judges and reviewers are told to verify assertions against the repository, and to name a trigger for every defect. That is what makes an unread patch defensible.
Structs§
- Candidate
View - One candidate as presented to a judge.
- Conduct
Answer - One answered question, for
ConductTask::answersand [ConductOutcome::answers]. - Conduct
Finding - One finding, as shown to the conductor across every review round — not
only the last one. See
ConductOutcome::roundsfor why every round matters here. - Conduct
Finished - A
Failed/Heldtask together with how its last run ended. - Conduct
Outcome - How a task’s last run ended, for a
Failed/Heldtask the conductor has not yet been shown — the “終わったタスク” the whole feature exists for. - Conduct
Rejection - One finding the fixer declined, and why — see
ConductRound::rejected. - Conduct
Round - One review round’s findings and how the fixer treated each one, for
ConductOutcome::rounds. - Conduct
Task - A task shown to
crate::conduct: either runnable (a dependency-blocking target), orRunningpast the stall threshold with no live daemon claiming it.priorityis shown so the conductor can see the order the loop already runs in — never so it can change it: nothing incrate::conduct::Decisioncarries a priority back. - Deputy
Prompt - What a conductor question’s deputy is told.
- Rebase
Conflict - What the fixer is told when a rebase of the winning branch stopped on a conflict.
- Review
Ctx - Everything a reviewer needs to know about the patch under review.
- Review
Patch - The patch text a stateless reconsideration call restates. See
ReviewReconsiderCtx::patch. - Review
Reconsider Ctx - Everything a reviewer needs to reconsider its vote after a split round.
- Review
Seat Report - One reviewer seat’s report, as shown to the rest of the panel during
reconsideration. Seats stay numbered, never named — the same convention
reviewitself uses for panel size, not a disclosure of identity. - Turn
- A judge’s contribution to the deliberation transcript.
Enums§
- Lens
- One of the fixed angles a reviewer seat is assigned.
- Owner
Word - What the owner said, handed to the agent that asked.
Constants§
- DEPUTY_
HEADING - Heading of the deputy prompt, which the end-to-end mock agent greps for.
- DUPES_
JUDGE_ MAX_ CHARS - Longest instruction the duplicate-work judge is given, in characters. A longer one is never truncated: it is refused unjudged.
- GITHUB_
ENGLISH_ HEADING - Heading of the fixed rule below; tests and callers key on it.
- MAX_
PATCH_ BYTES - Patches above this size are truncated in the prompt; the judge is pointed at the branch instead. Agent context windows are large but not free, and a 10 MB vendored-dependency diff is not read by anyone anyway.
- QUESTION_
RESUMED_ HEADING - Heading of
question_resumed; the mock agent intests/commonkeys on it.
Functions§
- advisor
- Prompt for one advisor seat in the design-deliberation stage
(
crate::graph::Runner::advise), run before any implementer touches the repository. - build_
cache_ note - What a seat is told about the shared build cache — one of two notes, chosen by whether the seat may write at all.
- conduct
- Prompt for
crate::conduct’s single seat. - deliberate
- Prompt for one deliberation turn.
- deputy
- See
DeputyPrompt. - dupes_
judge - The brief for the one-shot duplicate-work judge.
claimsare the rendered matches (which task / run / pull request owns what);instructionis the text of the work being filed. The text is data: the judge is told not to obey anything inside it. - final_
vote - Prompt for the private final vote.
- fix
- Prompt for the fixer, given a round’s findings.
- gate_
fix - Prompt for the fixer when the final
verify.gatefailed on a tree the reviewers had already cleared. - github_
english - The rule that everything landing on GitHub is English, whatever
[graph] languagesays and whatever language the task was written in. - github_
english_ finding_ titles github_englishfor a reviewer: the only thing of theirs that reaches GitHub is a finding’stitle, which the pull request body lists.- implement
- Prompt for an implementer.
- judge
- Prompt for a blind judge.
- nudge
- Follow-up when a reply could not be parsed.
- operator_
fix - Prompt for a targeted, operator-triggered fix: specific, already-recorded findings routed to a fixer outside the normal review round sequence.
- question_
resumed - The prompt that resumes a seat whose
magi askis gone, so the owner’s word still reaches the agent that already holds the context. - rebase_
conflict - See
RebaseConflict. - resume_
after_ drop - Follow-up when the CLI hung up before delivering an answer.
- resume_
incomplete - Follow-up when the CLI’s own turn ended cleanly — a usable, non-empty, exit-0 reply — but held none of the structured report this step reads back.
- review
- Prompt for a reviewer of the winning patch.
- review_
reconsider - Prompt for the one round of reconsideration a split review vote earns.
- synthesize_
brief - Prompt for the synthesis seat that blends the advisors’ proposals into a
design brief carried in the implementer’s prompt
(
crate::prompt::implement’sbriefargument). - with_
overlay - Append the project’s overlay for a node, under a heading of its own.