This folder consolidates, in a single location, the SoT for the project's five multi-agent roles plus the Universal Cycle skeleton. It is modeled on the role system of a Korean newspaper, and each role is self-contained in its capability boundary, I/O contract, and prompt templat
How to install README?
alfadur7/llm-wiki-newsroom/readme
$curl -o .claude/agents/README.md https://raw.githubusercontent.com/alfadur7/llm-wiki-newsroom/HEAD/.claude/agents/README.mdInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install README by running `curl -o .claude/agents/README.md https://raw.githubusercontent.com/alfadur7/llm-wiki-newsroom/HEAD/.claude/agents/README.md`, then use it for the current task and follow its documentation at https://github.com/alfadur7/llm-wiki-newsroom.
.claude/agents/README.md
| 1 | # Agents — SoT for the 5 Roles |
| 2 | |
| 3 | This folder consolidates, in a single location, the SoT for the project's five multi-agent roles plus the Universal Cycle skeleton. It is modeled on the role system of a Korean newspaper, and each role is self-contained in its capability boundary, I/O contract, and prompt template. |
| 4 | |
| 5 | ## The 5 Roles |
| 6 | |
| 7 | | Role | SoT | |
| 8 | |---|---| |
| 9 | | Editor-in-Chief | [editor-in-chief.md](editor-in-chief.md) | |
| 10 | | Reporter | [reporter.md](reporter.md) | |
| 11 | | Columnist | [columnist.md](columnist.md) | |
| 12 | | Desk | [desk.md](desk.md) | |
| 13 | | Copy Editor | [copyeditor.md](copyeditor.md) | |
| 14 | |
| 15 | For the one-line announce on invocation plus the role-prefix format of the `Agent` `description` argument, see [`commands/README.md` "Announce Before Delegating"](../commands/README.md#convention--announce-before-delegating). |
| 16 | |
| 17 | ## Layer × Cycle Matrix (design skeleton) |
| 18 | |
| 19 | The project's essential design skeleton is a two-axis matrix of **content Layer × Universal Cycle**. Each cell maps to a responsible role. |
| 20 | |
| 21 | | Layer | GROUND | APPLY | VERIFY | ADAPT | |
| 22 | |---|---|---|---|---| |
| 23 | | L1 raw | (external) | (external) | format integrity (manual) | re-collect | |
| 24 | | L2-1 source | Reporter | Reporter | Copy Editor + Desk (sub-trigger) | Reporter | |
| 25 | | L2-2 stub | Reporter | Reporter | Copy Editor + Desk | Reporter | |
| 26 | | L2-2 full hub | Columnist | Columnist | Copy Editor + **Desk** | Columnist | |
| 27 | | L2-2 timeline | Columnist | Columnist | Copy Editor + Desk | Columnist | |
| 28 | | L2-3 cluster overview | Columnist | Columnist | Copy Editor + **Desk** | Columnist | |
| 29 | | L2-3 theme contradiction | Columnist | Columnist | Copy Editor + **Desk** | Columnist | |
| 30 | | L2-3 synthesis·trail | Columnist | Columnist | Copy Editor + Desk | Columnist | |
| 31 | | L2-4 root overview·contradiction | Columnist | Columnist | Copy Editor + **Desk** | Columnist | |
| 32 | | Meta (index·log·_clusters·_graph·_backlinks) | (external) | tools/build.py | Copy Editor | tools/build.py | |
| 33 | |
| 34 | **Editor-in-Chief**: the meta layer outside the matrix — oversees entry, routing, gates, escalation, and log appends across all cycles. |
| 35 | |
| 36 | For Layer definitions and content formats, see [`.claude/layers/README.md`](../layers/README.md). For each content type's page format, authoring, and rubric, see [`.claude/layers/`](../layers/). L2-2 `stub` vs `full hub` is distinguished not by the shape of the output but by the **authoring act** — the definition lives in [`layers/hub.md`](../layers/hub.md) "Authoring acts — stub authoring vs full hub authoring". |
| 37 | |
| 38 | The **essential definitions of the four Universal Cycle stages** (what each of GROUND·APPLY·VERIFY·ADAPT is) are the single SoT in [`CLAUDE.md` "Universal Cycle"](../../CLAUDE.md#universal-cycle). This matrix orthogonalizes those four stages against the Layer axis and shows **only the role mapping** — the fact that GROUND·APPLY·ADAPT repeat in the same role cell reflects the pattern of one role performing read·write·rewrite together within its own context (Cognition Principle 1: full context, no message-passing loss). **Cognition Principle 2**: actions carry implicit decisions — when two roles act on the same area, their outputs embed conflicting implicit decisions, so every capability area has exactly one owning role and multi-role work runs as a sequential chain, not a parallel merge. |
| 39 | |
| 40 | ## Content Verification Ladder |
| 41 | |
| 42 | The VERIFY column of the matrix above is instantiated as a **ladder that climbs from the lowest-cost, lowest-determinism stage upward**. The principle: defects that an automated stage will catch are not pushed all the way up to a human cycle. The guideline layer has an isomorphic counterpart — [editor-in-chief.md § Guideline Verification Ladder](editor-in-chief.md#guideline-verification-ladder) — for changes to the instruction SoTs themselves. |
| 43 | |
| 44 | | Stage | Owner | Cost | Determinism | Hand-off on failure | |
| 45 | |---|---|---|---|---| |
| 46 | | 0. Post-edit hook | [`.claude/hooks/*.sh`](../hooks/) | 0 | deterministic | lint-chain-guard auto-block / dispatch.sh advisory | |
| 47 | | 1. self-VERIFY₀ (target-scope lint) | author (Reporter·Columnist) | low | deterministic | hand off to VERIFY₁ after 2 self-attempts on the same cause | |
| 48 | | 2. VERIFY₁ (full deterministic lint) | Copy Editor [`tools/lint.py`](../../tools/lint.py) | low | deterministic | ADAPT₁ → back to author | |
| 49 | | 3. VERIFY₂ (qualitative review) | Desk (6 lenses·persona) | medium | probabilistic | ADAPT₂ → author → back to VERIFY₁ | |
| 50 | | 4. Publish gate | Editor-in-Chief | low | deterministic | 3rd FAIL on same cause → escalate to human | |
| 51 | | 5. Human reviewer gate | the wiki operator | high | — | entered under the conditions in [`CLAUDE.md` "Human Reviewer Gate"](../../CLAUDE.md#human-reviewer-gate) | |
| 52 | |
| 53 | The straight-line instances of ladder stages 1·2·3 for L2-3·L2-4 content are in "Standard ADAPT chain" below. The rule for escalating stages when the same cause recurs is in "ADAPT Escalation" beneath that. |
| 54 | |
| 55 | **L2-2 stub obligation**: immediately after a cycle that newly authors `wiki/entities·concepts·timelines/*.md`, a Desk VERIFY₂ call is man |
Related
6 picksType
- documentation-analyst-writerUse this agent when you need to analyze existing documentation and create new or updated documentation that strictly adheres to project-specific documentation standards defined in claude.md.Jul 2026
- impeccable-documenterRecords DESIGN.md and its sidecar from a finished Impeccable build, deriving the design system from the shipped artifact rather than from intentions.Jul 2026
- document-specialistExternal Documentation & Reference SpecialistJul 2026
- writerTechnical documentation writer for README, API docs, and comments (Haiku)Jul 2026
- changelogWrites changelog entries for Activepieces releases. Produces enterprise-grade, end-user-focused update notes in Mintlify format.Jul 2026
- localization-leadOwns internationalization architecture, string management, locale testing, and translation pipeline. Use for i18n system design, string extraction workflows, locale-specific issues, or translation…May 2026
