Speed vs Governance: Different Organizational Needs
Startups prioritize: shipping fast (the product must reach users before funding runs out), flexibility (the tech stack may change as the product pivots), minimal process (every process that slows development is a risk), and pragmatism (the right decision is the one that ships). Startup AI rules should be: minimal (cover the essentials, nothing more), flexible (allow the team to experiment and evolve), and fast to write (30 minutes, not 3 days). The rule file is: a lightweight guide, not a governance document.
Enterprises prioritize: compliance (regulatory requirements must be met at all times), consistency (1000 developers across 200 repos must follow the same standards), governance (who changed the rules, when, and why — auditable), risk management (a bad AI-generated code pattern could affect millions of users), and stability (the standards evolve slowly after thorough review). Enterprise AI rules should be: comprehensive (cover every concern), governed (approval workflows, versioning, audit trail), and enforced (CI checks, mandatory compliance).
The same CLAUDE.md file format serves both. The difference is: content (30 rules for startup, 100+ for enterprise), strictness (mostly flexible for startup, mostly strict/mandatory for enterprise), management (one developer writes startup rules, a committee governs enterprise rules), and tooling (manual file for startup, RuleSync dashboard for enterprise). The format is a constant; the approach scales with organizational maturity.
Startup Rules: Minimal, Flexible, Ship-Focused
A startup CLAUDE.md should contain: the tech stack (Next.js, TypeScript, Tailwind, Drizzle, Neon — 50 words), core patterns (Server Components default, Zustand for state, TanStack Query for API data — 100 words), critical security rules (validate inputs, parameterized queries, no secrets in code — 50 words), and nothing else. Total: 200-300 words. The file is: written in 15 minutes, covers the essentials, and allows the AI maximum flexibility for everything not explicitly covered.
What startups should NOT put in AI rules: detailed style guides (the formatter handles style), comprehensive testing requirements (tests evolve as the product stabilizes), elaborate architecture patterns (the architecture is still forming), and governance processes (there is nothing to govern yet — 3 developers making decisions in Slack). These additions: slow down rule writing (which delays actual coding), over-constrain the AI (which prevents the flexibility startups need), and will change as the product pivots (creating maintenance debt).
The startup rule philosophy: rules should prevent mistakes (security, data integrity) not prescribe solutions (architecture, patterns). At the startup stage: the team is still discovering the right patterns. Prescribing patterns prematurely: locks in uninformed decisions. Preventing mistakes: is always correct regardless of how the product evolves. Write: "validate all inputs" (prevents mistakes). Do not write: "use the CQRS pattern for all data flows" (prescribes a solution that may not fit).
- 200-300 words total: stack + core patterns + security. Written in 15 minutes
- Cover: what prevents mistakes (security, data integrity). Skip: what prescribes solutions
- Flexible: allow AI to explore patterns the team has not settled on
- No governance: 3 developers, one writes the rules, everyone agrees in Slack
- Philosophy: prevent mistakes always, prescribe patterns only after they are proven
Startup rule: 'Validate all inputs with Zod' (prevents mistakes — always correct). Not: 'Use the CQRS pattern for all data flows' (prescribes a solution — may not fit after a pivot). At the startup stage: the team is still discovering the right patterns. Prescribing prematurely locks in uninformed decisions.
Enterprise Rules: Comprehensive, Governed, Compliance-Ready
An enterprise CLAUDE.md system should contain: organization baseline (TypeScript strict, security standards, testing requirements, accessibility compliance, naming conventions — 500-800 words in a centralized ruleset), framework-specific rulesets (React + Next.js conventions, Express API patterns, database standards — 200-400 words each), compliance-specific rules (GDPR data handling, audit logging, encryption at rest — 200-400 words), and team-specific overrides (team A's microservice patterns, team B's monolith conventions — 100-200 words each). Total: 1000-2000 words across composable rulesets.
What enterprises need that startups do not: approval workflows (rule changes reviewed by a committee or designated owner), versioning and rollback (ruleset v3 can be rolled back to v2 if a problem is found), audit trail (who changed which rule, when, and why — for compliance audits), CI enforcement (rulesync check fails the build if rules are outdated or misconfigured), and cross-team consistency (200 repos follow the same baseline, verified automatically). These features are: unnecessary for a 3-person startup but essential for a 200-person engineering organization.
The enterprise rule philosophy: rules should enforce standards (compliance, security, consistency) and enable governed flexibility (teams customize within the baseline). The baseline is: non-negotiable (mandatory security rules, naming conventions, testing requirements). The customization is: team-governed (each team can add framework-specific rules within the baseline). The combination: organization-wide consistency with team-level autonomy. RuleSync enables this: centralized baseline + composable framework rulesets + per-team overrides.
- 1000-2000 words across composable rulesets: baseline + framework + compliance + team overrides
- Approval workflows: rule changes reviewed by committee or designated owner
- Versioning and rollback: ruleset v3 to v2 if problems found. Audit trail for compliance
- CI enforcement: rulesync check fails build on outdated or misconfigured rules
- Philosophy: enforce standards (compliance, security) + enable governed flexibility (team customization)
The Maturity Progression: Startup to Enterprise
Stage 1 (Seed/Early, 1-5 devs): no rule file or a 100-word stack description. The team communicates conventions verbally. The AI generates generic patterns. Rule investment: 0-15 minutes. Value: low (team is small enough that verbal communication works). Trigger for Stage 2: the first developer joins who was not in the original conversations (they generate code that does not match conventions).
Stage 2 (Growth, 5-20 devs): a 300-800 word CLAUDE.md committed to each repo. Core conventions are documented. New developers read the file and generate convention-matching code. Rule investment: 30-60 minutes per repo. Value: high (conventions are shared, AI generates consistent code). Trigger for Stage 3: the team grows beyond 20 developers or spans 10+ repos (manual rule file maintenance becomes unsustainable).
Stage 3 (Scale, 20-100+ devs): centralized rule management with composable rulesets. Organization baseline + framework rulesets + team overrides. RuleSync or shared git repo for distribution. CI enforcement. Approval workflows for changes. Rule investment: 2-4 hours initial setup, 30 minutes per rule change. Value: critical (consistency across 50+ repos, compliance verified, onboarding standardized). Trigger for Stage 4: regulatory compliance requirements (SOC 2, HIPAA, GDPR mandate auditable AI governance).
- Stage 1 (1-5 devs): no file or 100 words. Verbal conventions. 0-15 min investment
- Stage 2 (5-20 devs): 300-800 word CLAUDE.md per repo. Written conventions. 30-60 min investment
- Stage 3 (20-100+ devs): centralized rulesets, CI enforcement, approval workflows. 2-4 hour setup
- Stage 4 (regulated): auditable governance, versioned rulesets, compliance-ready. Enterprise tooling required
- Trigger: each stage is triggered by the problem the previous stage cannot solve (verbal fails at 5, manual fails at 20)
Verbal conventions fail at 5 developers (new hire does not know them). Committed file fails at 20 developers (manual maintenance across 10 repos). Centralized management fails at regulated scale (no audit trail). Each trigger: the moment the current approach demonstrably cannot solve the growing problem.
Common Mistakes by Organization Size
Startup mistake: over-engineering rules. A 3-person startup creates a 2000-word CLAUDE.md with approval workflows, versioning, and composable rulesets. The overhead: exceeds the benefit. The rules: constrain the team's ability to pivot. The governance: is unnecessary for 3 people. Fix: write 200-300 words covering stack + security. Add rules as conventions emerge from actual coding, not anticipation.
Enterprise mistake: under-investing in rules. A 200-person engineering org has a 100-word CLAUDE.md in each repo ("Use TypeScript and React") with no governance. Result: 200 repos with inconsistent conventions, no baseline enforcement, new developers generate different patterns in each repo, and compliance audits find ungoverned AI usage. Fix: invest in centralized rule management. The upfront cost (2-4 hours) prevents: months of inconsistency-driven tech debt.
Growth-stage mistake: not evolving rules as the team grows. The CLAUDE.md written for 5 developers is still the same at 30 developers. The file does not cover: the new backend patterns, the second database, or the mobile app conventions. New developers: read outdated rules and generate outdated patterns. Fix: review the rule file quarterly. Add rules for new patterns. Remove rules for deprecated patterns. The rule file should: reflect the current codebase conventions, not the conventions from when the file was first written.
A 3-person startup with composable rulesets, approval workflows, and CI enforcement: the governance overhead exceeds the coding time. Meanwhile: a 200-person org with a 100-word CLAUDE.md has 200 inconsistent repos. Match the rule investment to the organization size. Over-engineering wastes time. Under-investing creates tech debt.
Comparison Summary
Summary of startup vs enterprise AI rules.
- Startup: 200-300 words, 15 minutes, stack + security, flexible, no governance, prevent mistakes
- Enterprise: 1000-2000 words, composable rulesets, governed, CI-enforced, compliance-ready
- Startup philosophy: prevent mistakes, do not prescribe patterns. Enterprise: enforce standards + governed flexibility
- Maturity: Stage 1 (verbal) → Stage 2 (committed file) → Stage 3 (centralized) → Stage 4 (auditable)
- Startup mistake: over-engineering rules (2000 words for 3 developers)
- Enterprise mistake: under-investing in rules (100 words for 200 developers)
- Growth mistake: not evolving rules (file written for 5 devs, now serving 30)
- Rule investment should match: team size, repo count, and compliance requirements