← all branches

exp/core-dossiers

safeviewing older commit
380a931 · incrementalPR #270reviewed 2026-07-09 19:17 UTC0H · 0M · 0L · 3I
The branch
Purpose
Provide a knowledge-base layer for the frontend + public-API surface that the backend ontology/FCIS docs never covered — one audited, non-redundant dossier per core-domain entity.
Goal
Stand up the capability-dossier system and populate it with audited core-domain dossiers. Zero runtime change.
Sub-goals
  • SG-1: Dossier rule (capability-dossier.md) — non-redundancy contract, 4-section schema, read-before-coding mandate
  • SG-2: /dossier skill — consult / build / refresh, two-pass audit choreography
  • SG-3: Reference corpus — _index.md, _template.md, _findings.md, 8 entity dossiers (Context excluded: no surface)
  • SG-4: Audit findings — 6 cross-cutting patterns (P1–P6) documented in _findings.md; P1 (outbox bypass at auth boundaries) and P5 (Context authz mismatch) spun off as separate tasks
The changes (whole branch)
What
Drops context.md (no FE/public-API surface); removes Context row from _index.md and updates count 9→8; adds explicit anti-pattern to capability-dossier.md; minor editorial on organization.md. 3 files, +9/−3 lines in this increment.
Why
Context was audited and found to have no dossier-worthy surface. The dossier system's own rules exclude it. Dropping it and codifying the exclusion prevents future drift.
Areas
.claude/rules+700.claude/skills/dossier+10060
Blast
13 files, +1076/−0 across .claude/ only. Zero runtime surface, no downstream consumers.
docs-only no-runtime-changes
CI checks· status API not accessible via current tokenCodeRabbit· no .coderabbit.yaml in repo

Findings · 3

correctness1

info

Count update 9→8 accurate; P5 cross-reference verified intact

.claude/skills/dossier/references/_index.md

_index.md references _findings.md P5 for the Context authz mismatch. P5 exists and is not removed by this commit — the finding is preserved even though the dossier was dropped.

conventions1

info

Excluded-entity block in _index.md is a new pattern not reflected in _template.md

.claude/skills/dossier/references/_index.md

First exclusion. The block is clear and well-written, but _template.md could document this exclusion-annotation pattern for future auditors.

improvement1

info

Anti-pattern example tightly couples to 'Context' by name

.claude/rules/capability-dossier.md

If Context later gets a FE surface and warrants a dossier, the concrete example in the anti-pattern bullet ('e.g. Context, a server-only grouping primitive') becomes misleading. Consider a more generic example.

History · 7 commits

  1. 8ff8773needs attentionincremental1H · 3M · 2L2026-07-27 17:46
  2. 7640070needs attentionincremental10H · 18M · 14L2026-07-18 02:11
  3. a516a9dneeds attentionincremental4H · 5M · 4L2026-07-17 04:38
  4. 910fc6aneeds attentionincremental1H · 9M · 6L2026-07-10 23:48
  5. 0b75850safeincremental0H · 0M · 0L2026-07-10 23:17
  6. 380a931safeincremental0H · 0M · 0L2026-07-09 19:17current
  7. 5a9ac90blockedfull5H · 8M · 5L2026-07-07 22:07