Skip to content

feat(knowledge): adversarial review protocol, design smells, object calisthenics, testability patterns#40

Merged
bdfinst merged 2 commits into
mainfrom
feat/knowledge-improvements
Jun 1, 2026
Merged

feat(knowledge): adversarial review protocol, design smells, object calisthenics, testability patterns#40
bdfinst merged 2 commits into
mainfrom
feat/knowledge-improvements

Conversation

@bdfinst
Copy link
Copy Markdown
Owner

@bdfinst bdfinst commented Jun 1, 2026

Summary

  • Adds 4 new language-agnostic knowledge files surfaced by competitive analysis against the code-craft plugin: adversarial-review-protocol, design-smells (14-row smell→pattern table + naming offender catalog), object-calisthenics (9 rules), and testability-patterns (decision flow + anti-patterns)
  • Wires new knowledge into 7 review agents via ## Knowledge Files and ## Self-Challenge sections; adds ## Build Progress to plan template + disk-write step to /build for session-reset durability
  • Adds ubiquitous-language skill (6-phase grep-based glossary extraction with 4-gate filter, append-mostly per-concept files, optional interview phase) and registers mermaid-diagramming + ubiquitous-language in agent-registry

Quality Gate

  • Tests: 237 passed, 0 failed
  • Type check: N/A (shell/markdown project)
  • Lint: N/A
  • Code review: 6 actionable issues found and fixed before commit (table header, CLAUDE.md counts, script path, grep injection hardening, self-challenge label clarity)

Test Plan

  • Install plugin locally and verify /code-review on a project — review agents should load knowledge/adversarial-review-protocol.md and append confidence level to their summaries
  • Run /plan on a task — output plan should include ## Build Progress section with checkboxes
  • Run /build on an approved plan — verify it edits the plan file checkboxes on disk
  • Run /ubiquitous-language src/ on a project with domain entities — verify .plans/domain/ is populated with per-concept files and _index.md
  • Verify agent-registry.md Knowledge Files table renders correctly (11 entries, 4-column header)

🤖 Generated with Claude Code

bdfinst and others added 2 commits June 1, 2026 16:02
…ct calisthenics, testability patterns

Closes gaps identified in competitive analysis against code-craft plugin.

**New knowledge files (4)**
- `knowledge/adversarial-review-protocol.md` — structured challenger loop
  with per-agent question sets; agents append confidence level to summary
- `knowledge/design-smells.md` — 14-row smell→pattern mapping table,
  finding format template, naming offender catalog
- `knowledge/object-calisthenics.md` — Jeff Bay's 9 rules with
  language-agnostic pseudocode and pragmatic exceptions table
- `knowledge/testability-patterns.md` — 4 patterns, "I Can't Test This
  Class" decision flow, anti-patterns table, references

**Agent wiring (8 agents)**
- structure-review: loads design-smells + object-calisthenics; Self-Challenge
- complexity-review: loads object-calisthenics; Self-Challenge
- test-review: loads testability-patterns; testability blocker detection; Self-Challenge
- arch-review, domain-review, security-review: Self-Challenge sections
- naming-review: loads naming offender catalog from design-smells
- domain-review: Skills section wired to ubiquitous-language; `Skill` added to tools
- spec-compliance-review: missing ## Skip section added (audit fix)

**Skill wiring**
- legacy-code: reference to testability-patterns added to Integration section

**File-anchored plan tracking**
- commands/plan.md: `## Build Progress` section added to plan template
- commands/build.md: step completion now written to plan file on disk via Edit tool

**New skill: ubiquitous-language**
- `skills/ubiquitous-language/SKILL.md` — 6-phase grep-based glossary
  extraction; 4-gate filter; append-mostly per-concept files; optional
  interview phase; language-agnostic
- `skills/ubiquitous-language/scripts/collect-domain-signals.sh` — signal
  collection script for JS/TS, C#, Java, Python, Go

**Registry updates**
- agent-registry.md: 4 new knowledge files registered; mermaid-diagramming
  and ubiquitous-language added to skills table

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
- knowledge/agent-registry.md: add missing Name column to Knowledge Files
  table header (was rendering as malformed markdown)
- CLAUDE.md: update knowledge files count 6→11 and skills count 33→34;
  add Ubiquitous Language to skills quick-reference list
- agents/complexity-review.md: clarify self-challenge borrows
  structure-review questions (no complexity-specific section exists)
- knowledge/adversarial-review-protocol.md: add ### complexity-review
  challenge questions section so complexity-review has its own set
- skills/ubiquitous-language/SKILL.md: fix script path to use
  .claude/skills/ (installed path, not source-tree path)
- collect-domain-signals.sh: add -- end-of-options separator to grep
  invocation to prevent option-injection via ROOT path

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@bdfinst bdfinst merged commit b75b8ec into main Jun 1, 2026
1 check passed
@bdfinst bdfinst deleted the feat/knowledge-improvements branch June 1, 2026 21:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant