docs: document package src entrypoint layout

[ErnestM1234]

Summary

• Document that top-level package src files are reserved for consumer entrypoints
• Add package-area reminders for React, core, CLI, compiler, and linter packages
• Update the compiler-local agent guide to treat non-entrypoint top-level files as legacy

Testing

• Not run (documentation-only change).

Greptile Summary

This PR adds consistent documentation across .claude/ agent-guide files declaring that top-level src files in every package are reserved for package entrypoints (e.g. index.ts, main.ts, subpath-exported files) and that all implementation logic belongs in src subdirectories.

• Adds an identical entrypoint-layout rule to .claude/CLAUDE.md, all five area rule files (cli.md, compiler.md, core.md, linter-plugins.md, react-packages.md), and the implement-feature skill.
• Updates packages/compiler/.claude/CLAUDE.md to show a "target organization" code-org tree (replacing config.ts with config/), labels the existing src/config.ts as a legacy location, and clarifies that non-entrypoint top-level files are not precedents for new code.

Confidence Score: 5/5

Documentation-only change with no runtime impact; safe to merge.

All eight changed files are agent-guide markdown files. The new entrypoint-layout rule is applied consistently across every relevant rule file and skill, and the compiler-local guide correctly distinguishes the current legacy config.ts from the desired config/ subdirectory. Verified against the actual packages/compiler/src/ layout — only index.ts and config.ts exist at the root, matching the documentation exactly.

No files require special attention.

Important Files Changed

Filename	Overview
.claude/CLAUDE.md	Adds the new entrypoint-layout convention to the global Code Conventions section; change is accurate and consistent with the rest of the file.
.claude/rules/cli.md	Appends subdirectory guidance to the CLI entry-point note; src/generated/ is already a subdirectory, so no conflict with the new rule.
.claude/rules/compiler.md	Adds entrypoint-only rule for the compiler's src/ root; matches the actual layout (only index.ts and the legacy config.ts exist at the root).
.claude/rules/core.md	Adds the entrypoint-only rule with concrete examples (index.ts, internal.ts, types.ts); clear and accurate.
.claude/rules/linter-plugins.md	Adds entrypoint rule with example subdirectory names (src/rules/, src/utils/); consistent with other rule files.
.claude/rules/react-packages.md	Adds entrypoint-only rule for .ts and .tsx files; consistent and accurate for the React package family.
.claude/skills/implement-feature.md	Adds a layout-check reminder to Phase 3 implementation guidance; well-placed and consistent with the other rule additions.
packages/compiler/.claude/CLAUDE.md	Adds "target organization" framing, relabels config.ts as a legacy location, and updates the config section reference; verified against the actual src/ layout (only index.ts and config.ts at the root).

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[New file needed in a package] --> B{Is it a package entrypoint?\ne.g. referenced in package.json\nexports / bin / documented subpath}
    B -- Yes --> C[Place at src/ root\ne.g. src/index.ts, src/main.ts]
    B -- No --> D[Place under a src/ subdirectory\ne.g. src/utils/, src/config/,\nsrc/rules/, src/passes/]
    D --> E[Implementation logic\nHelpers / Config / Types\nComponents / Hooks / Commands]
    C --> F[Package entrypoints\nConsumed via package.json exports\nor bin entries]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[New file needed in a package] --> B{Is it a package entrypoint?\ne.g. referenced in package.json\nexports / bin / documented subpath}
    B -- Yes --> C[Place at src/ root\ne.g. src/index.ts, src/main.ts]
    B -- No --> D[Place under a src/ subdirectory\ne.g. src/utils/, src/config/,\nsrc/rules/, src/passes/]
    D --> E[Implementation logic\nHelpers / Config / Types\nComponents / Hooks / Commands]
    C --> F[Package entrypoints\nConsumed via package.json exports\nor bin entries]

Loading

_{Reviews (2): Last reviewed commit: "docs: document package src entrypoint la..." | Re-trigger Greptile}