How this skill is triggered — by the user, by Claude, or both
Slash command
/deadfish-teams:deadfish-docsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
| Doc | Budget (chars) | Content |
docs/living/)| Doc | Budget (chars) | Content |
|---|---|---|
| TECH_STACK.md | 3200 | Languages, frameworks, deps, versions |
| PATTERNS.md | 3200 | Architecture patterns, conventions, idioms |
| PITFALLS.md | 2800 | Known gotchas, footguns, anti-patterns |
| RISKS.md | 2000 | Security, operational, business risks |
| PRODUCT.md | 2800 | Features, API surface, user-facing behavior |
| WORKFLOW.md | 2800 | CI/CD, scripts, deployment, dev workflow |
| GLOSSARY.md | 2000 | Domain terms, abbreviations, naming |
| Total | ~18800 |
.deadfish/reconcile/<track_id>.trigger exists.mcp__codex-planner__codex): independent review verdicts.For each of the seven living docs:
tracks/<track_id>/SPEC.md.base_commit..HEAD) and relevant commits.doc: TECH_STACK.md
action: UPDATE # UPDATE or NOP
proposed_diff: |
+ - **PyYAML 6.0**: YAML parsing for sentinel blocks.
rationale: Track added parse-blocks.py importing yaml.
evidence:
- file: bin/parse-blocks.py
- file: requirements.txt
Phase 1 output is proposals only. Doc-keeper does not apply edits.
Run for each proposal where action=UPDATE.
Round 1:
verdict: APPROVE | REJECT | MODIFYreasoningconcernsmodified_diff (required for MODIFY)Decision table:
APPROVE -> auto_approved (apply original proposal)REJECT -> auto_rejected (skip apply)MODIFY with semantically equivalent diff -> auto_approved_modifiedRound 2:
Round 3:
escalated_to_human.Integrator actions:
docs/living/*.docs(deadfish): Reconcile docs for track '<track_id>'.deadfish/reconcile/<track_id>.yaml..deadfish/reconcile/<track_id>.trigger.Reconciliation record schema:
track_id: v32-realignment
timestamp: 2026-02-09T14:30:00Z
trigger: .deadfish/reconcile/v32-realignment.trigger
docs_evaluated: 7
proposals:
TECH_STACK:
action: UPDATE
debate_rounds: 1
outcome: auto_approved
reviewers: {opus: APPROVE, gpt52: APPROVE}
docs_changed: [TECH_STACK]
commit_sha: abc123
debate_log:
- doc: TECH_STACK
round: 1
reviewer: opus
verdict: APPROVE
reasoning: Dependency manifest changed with matching implementation use.
Required top-level keys:
track_id, timestamp, trigger, docs_evaluated, proposals, docs_changed, commit_shaDoc-keeper emits reconciliation-only sentinel:
action: RECONCILE
track_id: <track_id>
trigger: .deadfish/reconcile/<track_id>.trigger
phase: proposal|debate|apply
status: READY_FOR_DEBATE|AUTO_APPLY|ESCALATE_HUMAN|COMPLETED
summary: <concise track-boundary reconciliation status>
If a doc exceeds 80% of budget, prefer compression edits before expansion.
npx claudepluginhub fredasterehub/deadfish-teamsUpdates READMEs, ADRs, docstrings, and docs after code changes using consolidation detection, slop scanning, accuracy verification, and quality gates.
Audits documentation against source code using git-based staleness detection. Run with no args for smart check or specify a path. Supports full audit, auto-fix, and check-only modes.
Generates docs from code, detects drift between docs and implementation, validates quality, and applies templates for READMEs, APIs, components, models, and guides.