Skip to content

docs(web): add boy-scout decomposition convention for accreted modules - #314

Merged
ryw merged 1 commit into
mainfrom
tembo/agents-md-boyscout-decomposition
Jul 18, 2026
Merged

docs(web): add boy-scout decomposition convention for accreted modules#314
ryw merged 1 commit into
mainfrom
tembo/agents-md-boyscout-decomposition

Conversation

@staging-tembo

@staging-tembo staging-tembo Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Summary

Encodes the methodology from #311 into web/AGENTS.md so coding agents follow it by default when working in web/.

New section — "Big grown-by-accretion modules: carve out, don't pile on":

  • Boy-scout, not big-bang: no dedicated refactor PRs; when a feature touches one of the accreted multi-domain modules, extract the domain being touched into its own module as part of that change instead of adding to the pile.
  • Concrete split patterns per module shape:
    • settings/actions.ts → per-domain action files (re-exporting from the original if needed for import stability)
    • runs-db.ts / workspace.ts → split along query-subject lines
    • large client components (agents-inventory.tsx) → extract the self-contained sub-tree being modified
  • Mechanical move + import update in the same PR as the motivating feature, with no behavior changes bundled into the move, so review cost stays near zero and the feature's own testing covers it.
  • Guardrails so the rule doesn't over-trigger:

The section links to #311 for the live offender table rather than duplicating it — line counts drift, and the issue stays the tracking source of truth.

Docs-only change: web/CLAUDE.md already imports AGENTS.md, and the root AGENTS.md already directs agents to read the subdir file, so no other files need touching.

Refs #311


Want tembo to make any changes? Add a comment with @staging-tembo and i'll get back to work!

View on Tembo View Agent Settings

@staging-tembo staging-tembo Bot added the tembo Pull request created by Tembo label Jul 18, 2026
@staging-tembo

staging-tembo Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor Author

Requesting review from @ryw who has experience with the following files modified in this PR:

  • web/AGENTS.md

@staging-tembo
staging-tembo Bot requested a review from ryw July 18, 2026 21:29
@ryw
ryw merged commit 8282d43 into main Jul 18, 2026
10 checks passed
@ryw
ryw deleted the tembo/agents-md-boyscout-decomposition branch July 18, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tembo Pull request created by Tembo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant