README

Name: README
Author: alfadur7

56stars10forks

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.md

Installs into the current project.

Summary

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

Files · 1

View on GitHub

.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

People who liked this also viewed

6 picks

Type

README

56stars10forks

View on GitHub

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.md

Installs into the current project.

Summary

Files · 1

View on GitHub

.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

People who liked this also viewed

6 picks

Type