Files

T

Дмитрий 0cf1406314 docs(observer): HK1 pre-check noted in README (ADR-010 compliance)

Verified Stop event collision before B5 registration:
- User-level (~/.claude/settings.json): Stop hook = agent-type
  Sonnet-4.6 economy compliance verifier (already wired in
  6-component arch).
- Project-level (.claude/settings.json): Stop slot empty.

observer-stop-hook will register as command-type entry in
project-level Stop array. Independent slot from user-level agent;
no overwrite, no collision. Per Pravila ADR-010 HK1 hard-rule.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-19 06:17:58 +03:00

notes

feat(observer): docs/observer/ scaffolding — README + STATUS + counter + JSONL seed

2026-05-19 06:07:42 +03:00

.read-counter.json

feat(observer): docs/observer/ scaffolding — README + STATUS + counter + JSONL seed

2026-05-19 06:07:42 +03:00

episodes-2026-05.jsonl

feat(observer): docs/observer/ scaffolding — README + STATUS + counter + JSONL seed

2026-05-19 06:07:42 +03:00

README.md

docs(observer): HK1 pre-check noted in README (ADR-010 compliance)

2026-05-19 06:17:58 +03:00

STATUS.md

feat(observer): docs/observer/ scaffolding — README + STATUS + counter + JSONL seed

2026-05-19 06:07:42 +03:00

README.md

Observer infrastructure

Passive evidence-loop for the Лидерра «brain» per ADR-011.

Files

episodes-YYYY-MM.jsonl — append-only JSONL, one line per Claude session. Written by tools/observer-stop-hook.mjs on Stop-event.
notes/YYYY-MM-DD-<slug>.md — optional MD notes for sessions with qualitative history.
STATUS.md — auto-generated dashboard. Regenerated per-commit by tools/status-md-generator.mjs.
.read-counter.json — C3 observer-of-observer counter. Updated on Read of observer files.

Lifecycle

Write: every Claude session ends with a JSONL append (Stop-hook).
Aggregate: /brain-retro skill reads JSONL each sprint, proposes regulatory candidates.
Surface: STATUS.md shows controllers + monthly stats.
Self-prune: C3 warns if 54 weeks pass without any read of observer files.

Privacy

PII filter (phone numbers, emails, tokens) is applied before every write — see tools/observer-pii-filter.mjs. gitleaks pre-push also scans observer files as part of full-history sweep.

Don't

Don't edit episodes-*.jsonl manually — it's append-only.
Don't write outside docs/observer/notes/ for hand-curated notes.
Don't change .read-counter.json manually — it's maintained by hooks.

HK1 pre-check (Pravila ADR-010) — verified 2026-05-19

Before registering tools/observer-stop-hook.mjs on Stop event (Task B5), verified collision against 6-component economy/skill-discipline architecture:

User-level ~/.claude/settings.json already has Stop hook: agent-type Sonnet-4.6 economy compliance verifier (analyzes transcript for claim-without-evidence violations).
Project-level .claude/settings.json — Stop slot empty.

Result: no overwrite. observer-stop-hook will be added as command-type entry in project-level Stop array. Project + user scopes are independent slots in Claude Code 2.x — both run on the same Stop event without conflict. The agent verifier (user scope) and the JSONL appender (project scope) have non-overlapping responsibilities.