v0.5.0 — all six architecture packs dogfooded + external-tool deferral

A hardening release — no new stacks. Every architecture pack was dogfooded read-only on a real production app and tuned from the findings, and a new external-tool-deferral config lets a team already running a static-analysis tool avoid duplicate findings.

Dogfooded + tuned (each find→fix→fold on a real OSS app)

• Rails (Mastodon) — concern-tree resolution for fat-model; service_object.max_loc axis fix.
• Python (a FastAPI service) — MobX… no: layer-leak grep fix, document_renderer pattern.
• React (a MobX/Next app) — MobX recognition, react.store.* budget, framework-idiom carve-outs.
• Laravel (BookStack) — layout-agnostic path globs, query_object/notification patterns.
• Express (NodeBB) — CommonJS export counting, api/-service recognition, project-local async-wrapper carve-out.
• Phoenix (Plausible) — from(x in Schema) precision, tiered Repo.preload vs query-building.

The recurring lesson: smell definitions + the "confirm-don't-count" discipline held on every stack; recognition mechanics broke on each codebase's real conventions (MobX/Next, domain layouts, CommonJS/api/, from-as-function-name) — dogfooding caught all of it.

Added

• External-tool preference (tools.architecture: enrich/prefer/report/off) — defer to reek/eslint/phpstan/credo instead of duplicating it; tool findings mapped to the findings schema.
• /ie-init opt-in for which lenses run + the tool preference.

Architecture stacks (6)

Rails · Python (FastAPI) · Laravel · Express · Phoenix · React

Full changelog: https://github.com/davidteren/intent-engineering/blob/main/CHANGELOG.md

v0.4.0 — Laravel + Express + Phoenix + React architecture stacks

Four new architecture stacks since v0.3.0 — Laravel, Express/Node, Phoenix/Elixir, and React — each authored research-first and added purely through the v0.3.0 stack registry (data + a catalog row, no lens/skill code changes). The architecture lens (5th lens) now covers six stacks.

Supported architecture stacks

• Rails · Python (FastAPI) · Laravel · Express/Node · Phoenix/Elixir · React

Added this release

• Laravel — 8 smells (fat-controller, fat-model, god-class, misused-service, query-in-view/N+1, logic-in-routes, fat-job, law-of-demeter) + 14-pattern catalog. Sources: Laravel best-practices canon, Laravel docs, laravel-actions, PSR-12.
• Express/Node — 8 smells (fat-route-handler, god-module, god-object, misused-service, layer-leak, fat-middleware, async-error-gap, law-of-demeter) + 12-pattern catalog. Sources: bulletproof-nodejs 3-layer, goldbergyoni nodebestpractices, Express docs, 12-factor.
• Phoenix/Elixir — 8 smells (fat-controller, context-bypass, god-context, fat-liveview, business-logic-in-changeset, god-module, process-misuse, law-of-demeter) + 11-pattern catalog. Sources: Phoenix Contexts guide, Elixir process/design anti-patterns, Ecto docs.
• React — 8 smells (god-component, logic-in-component, fat-hook, prop-drilling, effect-overuse, god-context, god-module, law-of-demeter) + 11-pattern catalog. Sources: React docs (You Might Not Need an Effect / hooks / context), patterns.dev, Martin Fowler.

Changed

• The architecture lens agent description is now stack-neutral (points at the registry) so it can't drift stale.
• check-contracts.rb — 75 → 105 checks (cross-references + registry consistency now cover every stack automatically).

Notes

• Each new pack's live dogfood on a real repo is pending (tracked in STATUS).

Full changelog: https://github.com/davidteren/intent-engineering/blob/main/CHANGELOG.md

v0.3.0 — Python architecture stack + stack registry

The architecture lens (5th lens) now audits Python services in addition to Rails — FastAPI-first, but the structural checks apply to any layered Python service. A new stack registry makes every future language/framework a data-only addition.

Added

• Python architecture stack — python-architecture.md (8 smells: fat-router, god-module, god-object, misused-service, business-logic-in-schema, fat-dependency, layer-leak, law-of-demeter) + python.yaml (13-pattern catalog) + a python.* threshold namespace. Dogfooded read-only on a real FastAPI service (healthy, near-zero false positives).
• Stack registry (references/stack-catalog.md) — one source of truth for stack detection + which packs each loads. The lens, the skills, and a stack-aware /ie-init read it, so adding a stack is two data files + a catalog row, not skill edits.
• Stack-aware /ie-init — scaffolds only the detected stack's threshold namespace + pattern policy.

Changed

• check-contracts.rb — §8 cross-references generalized to every stack; new §10 enforces stack-registry consistency. 67 → 75 checks.

Roadmap

Queued architecture stacks (research-first, drop into the registry): PHP/Laravel (next), Express/Node, Elixir/Phoenix, React.

Full changelog: https://github.com/davidteren/intent-engineering/blob/main/CHANGELOG.md

v0.2.0 — first public release

First public release of intent-engineering — a Claude Code plugin that checks whether software behaves the way a reasonable developer or user already expects.

Highlights

• 5 review lenses — predictability, convention, simplicity, experience (universal) + architecture (Rails-only, code/audit). Parallel sub-agents → scored, deduplicated, confidence-gated findings with concrete fixes.
• 5 skills — /ie-init, /ie-plan-assist, /ie-validate-plan, /ie-review, /ie-audit across planning, plan validation, code review, and codebase audit.
• .intense project config — lens toggles, pattern policy, architecture thresholds (project overrides plugin defaults).
• Rails architecture audit + a 14-pattern catalog (heuristic-first; optional reek/flog/brakeman enrichment).
• Researched knowledge base bundled in the plugin — principles, framework conventions, agnostic topics, each with violation-smell checklists and cited sources.
• Contract-integrity CI — scripts/check-contracts.rb (67 checks) runs on every PR.

Install

```
/plugin marketplace add https://github.com/davidteren/intent-engineering
/plugin install intent-engineering
```

See CHANGELOG.md for the full list, README.md for the overview, and AGENTS.md for the contributor guide.

MIT licensed.

---

Announcement

Shipped intent-engineering — a Claude Code plugin that catches surprising code before it ships. Five review lenses (predictability, convention, simplicity, experience, architecture) run across planning, plan validation, code review & audit → scored findings, each naming the broken expectation with a concrete fix. Tunable per repo via .intense, MIT-licensed, with a 67-check contract test in CI.

→ https://github.com/davidteren/intent-engineering