docs(web): add boy-scout decomposition convention for accreted modules - #314
Merged
Conversation
Contributor
Author
|
Requesting review from @ryw who has experience with the following files modified in this PR:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Encodes the methodology from #311 into
web/AGENTS.mdso coding agents follow it by default when working inweb/.New section — "Big grown-by-accretion modules: carve out, don't pile on":
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 linesagents-inventory.tsx) → extract the self-contained sub-tree being modifiedmcp-providers.ts, ~95% flat catalog data) are exempt — length is not the risk signal, unrelated logic domains areThe 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.mdalready importsAGENTS.md, and the rootAGENTS.mdalready directs agents to read the subdir file, so no other files need touching.Refs #311