const{Fragment:e,jsx:n,jsxs:a}=arguments[0];function _createMdxContent(l){const t={a:"a",blockquote:"blockquote",code:"code",em:"em",figure:"figure",h2:"h2",h3:"h3",h4:"h4",hr:"hr",li:"li",ol:"ol",p:"p",pre:"pre",span:"span",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...l.components};return a(e,{children:[n(t.p,{children:a(t.em,{children:[n(t.strong,{children:"Update (February 2026):"})," This post has been updated to reflect major features added in v1.10+, including TDD enforcement, Claude Code AI integration with 7 domain-specific skills, and the planning protocol framework."]})}),"\n",n(t.hr,{}),"\n",a(t.p,{children:["In January 2026 I shipped something that had been brewing in my mind for months: ",n(t.a,{href:"https://www.npmjs.com/package/@raftlabs/raftstack",children:"RaftStack"}),", an NPM CLI tool that standardizes how we initialize and maintain TypeScript projects at RaftLabs. What started as an idea to improve our development workflow turned into a full development framework that's now adopted by all 30+ engineers in our organization."]}),"\n",n(t.p,{children:"Here's the story of why I built it, what problems it solves, and how 20 seconds of setup time now saves us days of repetitive work."}),"\n",n(t.h2,{children:"Why RaftLabs Encouraged This"}),"\n",n(t.p,{children:"One thing I love about working at RaftLabs is the culture of continuous improvement. When I pitched the idea of building internal tooling to standardize our workflows, leadership didn't just approve it—they gave me a full week to focus on nothing else. That kind of investment in developer experience is rare, and it's why projects like RaftStack can go from idea to organization-wide adoption so quickly."}),"\n",a(t.p,{children:["RaftLabs has always delivered quality products to clients. But as we scaled from a small team to 30+ engineers, we recognized an opportunity: what if we could make excellence the ",n(t.em,{children:"default"})," rather than something each team had to figure out independently?"]}),"\n",n(t.h2,{children:"The Challenge: Scaling Engineering Excellence"}),"\n",n(t.p,{children:"RaftLabs is a service-based company that builds products for clients—sometimes MVPs that ship in a month, sometimes enterprise projects that span six months or more. We're proud of the diverse, challenging work we take on. At any given time, multiple projects run in parallel, each with its own technical requirements and timelines."}),"\n",n(t.p,{children:"As we grew, we noticed a pattern common to many scaling engineering teams: without explicit standards, each project evolved its own conventions."}),"\n",n(t.h3,{children:"Repository Drift"}),"\n",n(t.p,{children:"Different projects had developed different practices. One used 4-space indentation, another used 2. Some had strict TypeScript configurations, others were more relaxed. Commit messages varied from beautifully formatted Conventional Commits to quick notes during crunch time."}),"\n",n(t.p,{children:"Some projects had well-organized Git hooks that validated commits and ran linting. Others—especially older ones or quick prototypes—didn't have these guardrails yet. None of this was due to lack of skill; our engineers are excellent. It was simply a coordination problem that every growing team faces."}),"\n",n(t.h3,{children:"The AI Tooling Opportunity"}),"\n",n(t.p,{children:"Here's an industry-wide observation: AI-assisted coding tools dramatically increase development speed, but they also amplify whatever patterns exist in your codebase—good or bad. Across the industry, teams have noticed that without guardrails, AI-generated code can lead to:"}),"\n",a(t.ul,{children:["\n",n(t.li,{children:"Larger files that could benefit from better separation of concerns"}),"\n",n(t.li,{children:"Relaxed type safety when strict typing would catch bugs earlier"}),"\n",n(t.li,{children:"Bigger pull requests that take longer to review thoroughly"}),"\n"]}),"\n",a(t.p,{children:["This isn't a criticism of AI tools—we love them and use them daily. It's recognition that ",n(t.em,{children:"any"})," tool that increases output velocity needs corresponding quality gates. The faster you can write code, the more important it becomes to have automated checks ensuring that code meets your standards."]}),"\n",n(t.h3,{children:"The Setup Time Sink"}),"\n",n(t.p,{children:"The most tangible problem was project initialization. Our engineers—skilled as they are—were spending valuable time on repetitive setup work:"}),"\n",a(t.ol,{children:["\n",n(t.li,{children:"Initialize a repo (Turborepo, NX, or similar)"}),"\n",n(t.li,{children:"Search through previous projects for proven configurations"}),"\n",n(t.li,{children:"Copy and adapt Husky hooks, Prettier config, ESLint rules"}),"\n",n(t.li,{children:"Debug integration issues when configs from different sources clashed"}),"\n",n(t.li,{children:"Document the setup for the team"}),"\n"]}),"\n",a(t.p,{children:["This process could take ",n(t.strong,{children:"2-3 days"})," of an engineer's time—time better spent solving actual client problems."]}),"\n",n(t.p,{children:"We had talented people doing repetitive work. That's the kind of inefficiency that begs for automation."}),"\n",n(t.h3,{children:"The Developer Workflow: Before vs After"}),"\n",n(t.p,{children:"Here's what this problem looked like in practice:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"mermaid","data-theme":"github-light",children:a(t.code,{"data-language":"mermaid","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"flowchart LR"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph Before["❌ Before RaftStack"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" direction TB"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" B1[Copy configs from old project] --\x3e B2[Debug integration issues]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" B2 --\x3e B3[Write documentation]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" B3 --\x3e B4[2-3 days later...]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph After["✓ After RaftStack"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" direction TB"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" A1[pnpm dlx @raftlabs/raftstack init] --\x3e A2[Answer 5 questions]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" A2 --\x3e A3[✓ Ready in 20 seconds]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' Before -.->|"Replaced by"| After'})})]})})}),"\n",n(t.h2,{children:"The Solution: One Command to Rule Them All"}),"\n",n(t.p,{children:"With full support from leadership, I set out to solve this properly. Not with documentation alone (though we have that too), not with templates (they drift over time), but with a CLI that makes best practices the path of least resistance."}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" init"})]})})})}),"\n",n(t.p,{children:"That's it. Run this command in any TypeScript repository, answer a few questions, and in about 20 seconds, your project has:"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Git Hooks"})," (Husky) for pre-commit, commit-msg, and pre-push validation"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Commit Standards"})," (Commitlint + cz-git) with an interactive commit wizard"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Code Formatting"})," (Prettier + lint-staged) that runs on every commit"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Branch Naming Rules"})," validated on every push"]}),"\n",a(t.li,{children:[n(t.strong,{children:"GitHub Integration"}),": PR templates, CI workflows, CODEOWNERS"]}),"\n",a(t.li,{children:[n(t.strong,{children:"AI Code Review"})," configuration (CodeRabbit or GitHub Copilot)"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Contributing Guidelines"})," and quick reference documentation"]}),"\n"]}),"\n",n(t.h3,{children:"Smart Detection, Zero Configuration"}),"\n",n(t.p,{children:"RaftStack automatically detects your project structure:"}),"\n",a(t.ul,{children:["\n",n(t.li,{children:"NX workspace? Detected."}),"\n",n(t.li,{children:"Turborepo? Detected."}),"\n",n(t.li,{children:"pnpm workspace? Detected."}),"\n",n(t.li,{children:"Single package? Detected."}),"\n"]}),"\n",n(t.p,{children:"It also figures out your package manager (npm, pnpm, or Yarn) and adapts all generated scripts accordingly. No manual configuration needed."}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"mermaid","data-theme":"github-light",children:a(t.code,{"data-language":"mermaid","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"flowchart TD"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Start[Scan Project] --\x3e NX{nx.json exists?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" NX --\x3e|Yes| T1[✓ NX Monorepo]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" NX --\x3e|No| Turbo{turbo.json exists?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Turbo --\x3e|Yes| T2[✓ Turborepo]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Turbo --\x3e|No| PNPM{pnpm-workspace.yaml?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PNPM --\x3e|Yes| T3[✓ pnpm Workspace]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PNPM --\x3e|No| T4[✓ Single Package]"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" T1 & T2 & T3 & T4 --\x3e PM[Detect Package Manager]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PM --\x3e L1{pnpm-lock.yaml?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" L1 --\x3e|Yes| PM1[✓ pnpm]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" L1 --\x3e|No| L2{yarn.lock?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" L2 --\x3e|Yes| PM2[✓ Yarn]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" L2 --\x3e|No| PM3[✓ npm]"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style T1 fill:#10b981"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style T2 fill:#10b981"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style T3 fill:#10b981"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style T4 fill:#10b981"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PM1 fill:#3b82f6"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PM2 fill:#3b82f6"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PM3 fill:#3b82f6"})})]})})}),"\n",n(t.h3,{children:"The Interactive Wizard"}),"\n",n(t.p,{children:"Instead of making assumptions, the CLI asks you what you need:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"plaintext","data-theme":"github-light",children:a(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{children:"? Select your project type: (auto-detected: Turborepo)"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"? Enable Asana task linking in commits?"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"? Configure AI code review (CodeRabbit/GitHub Copilot)?"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"? Set up CODEOWNERS for automatic reviewer assignment?"})})]})})}),"\n",n(t.p,{children:"Based on your answers, it generates exactly what you need—nothing more, nothing less."}),"\n",n(t.h2,{children:"What Gets Created"}),"\n",n(t.p,{children:"After running the CLI, your project gains this structure:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"plaintext","data-theme":"github-light",children:a(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{children:"your-project/"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .husky/"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── pre-commit # Runs lint-staged & Prettier"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── commit-msg # Validates commit format"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ └── pre-push # Validates branch names + TDD enforcement"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .github/"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── PULL_REQUEST_TEMPLATE.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── workflows/pr-checks.yml"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── CODEOWNERS"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ └── QUICK_REFERENCE.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .claude/"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── skills/ # 7 domain-specific AI skills"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── react.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── backend.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── database.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── seo.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── code-quality.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ ├── tdd.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ │ └── asana.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ └── commands/ # 8 slash commands"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── shape.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── discover.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ ├── inject.md"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"│ └── ..."})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── commitlint.config.js"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .czrc"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── cz.config.js"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .lintstagedrc.js"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .prettierrc"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"├── .prettierignore"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{children:"└── CONTRIBUTING.md"})})]})})}),"\n",n(t.p,{children:"Every file is generated with sensible defaults that work together out of the box."}),"\n",n(t.h2,{children:"Enforcing Quality Through Constraints"}),"\n",a(t.p,{children:["The real power isn't in what the CLI creates—it's in what it ",n(t.em,{children:"prevents"}),"."]}),"\n",n(t.h3,{children:"Commit Message Validation"}),"\n",n(t.p,{children:"Every commit must follow the Conventional Commits format:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:a(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# This works"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"git"}),n(t.span,{style:{color:"#032F62"},children:" commit"}),n(t.span,{style:{color:"#005CC5"},children:" -m"}),n(t.span,{style:{color:"#032F62"},children:' "feat(auth): add social login support"'})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# This fails immediately"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"git"}),n(t.span,{style:{color:"#032F62"},children:" commit"}),n(t.span,{style:{color:"#005CC5"},children:" -m"}),n(t.span,{style:{color:"#032F62"},children:' "fixed the thing"'})]})]})})}),"\n",n(t.p,{children:"No more cryptic commit history. Every commit clearly states what changed and why."}),"\n",n(t.h3,{children:"Branch Name Validation"}),"\n",n(t.p,{children:"Push attempts are blocked unless your branch follows the naming convention:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:a(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# This works"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"git"}),n(t.span,{style:{color:"#032F62"},children:" push"}),n(t.span,{style:{color:"#032F62"},children:" origin"}),n(t.span,{style:{color:"#032F62"},children:" feature/user-authentication"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# This is rejected"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"git"}),n(t.span,{style:{color:"#032F62"},children:" push"}),n(t.span,{style:{color:"#032F62"},children:" origin"}),n(t.span,{style:{color:"#032F62"},children:" my-branch"})]})]})})}),"\n",a(t.p,{children:["Protected branches (",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"main"})})})}),", ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"develop"})})})}),", ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"staging"})})})}),", ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"production"})})})}),") can't be pushed to directly—all changes must go through pull requests."]}),"\n",n(t.h3,{children:"Pre-commit Quality Gates"}),"\n",n(t.p,{children:"Before any commit succeeds, lint-staged runs Prettier on your staged files. Inconsistent formatting? Fixed automatically. No debates about code style in PRs."}),"\n",n(t.p,{children:"Here's the complete quality gate pipeline:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"mermaid","data-theme":"github-light",children:a(t.code,{"data-language":"mermaid","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"flowchart TD"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph PreCommit["🔍 Pre-Commit Stage"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC1[git commit] --\x3e PC2[lint-staged triggers]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC2 --\x3e PC3[Prettier formats staged files]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC3 --\x3e PC4[ESLint checks code]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC4 --\x3e PC5{All pass?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC5 --\x3e|No| PC6[❌ Commit blocked]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC5 --\x3e|Yes| PC7[commitlint validates message]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC7 --\x3e PC8{Valid format?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC8 --\x3e|No| PC6"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PC8 --\x3e|Yes| PC9[✓ Commit succeeds]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph PrePush["🚀 Pre-Push Stage"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP1[git push] --\x3e PP2[Validate branch name]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP2 --\x3e PP3{Valid pattern?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP3 --\x3e|No| PP4[❌ Push blocked]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP3 --\x3e|Yes| PP5[Run full test suite]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP5 --\x3e PP6{Coverage ≥ 80%?}"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP6 --\x3e|No| PP4"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" PP6 --\x3e|Yes| PP7[✓ Push succeeds]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' PC9 -.->|"Next: push changes"| PP1'})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PC6 fill:#ef4444"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PP4 fill:#ef4444"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PC9 fill:#10b981"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style PP7 fill:#10b981"})})]})})}),"\n",n(t.h2,{children:"The TDD Revolution"}),"\n",a(t.p,{children:["The most impactful addition to RaftStack came in v1.10: ",n(t.strong,{children:"TDD enforcement at the Git level"}),"."]}),"\n",n(t.h3,{children:"You Can't Push Broken Code Anymore"}),"\n",n(t.p,{children:"Here's the problem we noticed: with AI-assisted development accelerating code production, it became easy to push code without running tests. Fast development is great, but not if it means broken tests accumulate in your main branch."}),"\n",n(t.p,{children:"The solution? Make it impossible:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"mermaid","data-theme":"github-light",children:a(t.code,{"data-language":"mermaid","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"sequenceDiagram"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" participant Dev as 👨‍💻 Developer"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" participant Hook as 🪝 Git Hook"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" participant Test as 🧪 Test Runner"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" participant Git as 📦 Git"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Dev->>Git: git push origin feature/new-api"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Git->>Hook: pre-push triggered"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Hook->>Test: pnpm test"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" alt Coverage < 80%"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Test--\x3e>Hook: ❌ Coverage: 72% (8% short)"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Hook--\x3e>Dev: 🚫 Push blocked!"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Note over Dev: Write more tests or
remove untested code"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Dev->>Dev: Add missing tests"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Dev->>Git: git push (retry)"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Git->>Hook: pre-push triggered"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Hook->>Test: pnpm test"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Test--\x3e>Hook: ✓ Coverage: 85%"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Hook--\x3e>Git: Proceed"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Git--\x3e>Dev: ✓ Push successful"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" else Coverage ≥ 80%"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Test--\x3e>Hook: ✓ Coverage: 85%"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Hook--\x3e>Git: Proceed"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Git--\x3e>Dev: ✓ Push successful"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})})]})})}),"\n",n(t.h3,{children:"The 80% Coverage Rule"}),"\n",n(t.p,{children:"Every push attempt now runs your full test suite. If coverage drops below 80%, the push is blocked with a clear message:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:a(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:[a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"❌"}),n(t.span,{style:{color:"#032F62"},children:" Test"}),n(t.span,{style:{color:"#032F62"},children:" coverage"}),n(t.span,{style:{color:"#032F62"},children:" is"}),n(t.span,{style:{color:"#032F62"},children:" below"}),n(t.span,{style:{color:"#032F62"},children:" 80%"}),n(t.span,{style:{color:"#24292E"},children:" (current: "}),n(t.span,{style:{color:"#032F62"},children:"72%"}),n(t.span,{style:{color:"#24292E"},children:")"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"Cannot"}),n(t.span,{style:{color:"#032F62"},children:" push"}),n(t.span,{style:{color:"#032F62"},children:" until"}),n(t.span,{style:{color:"#032F62"},children:" coverage"}),n(t.span,{style:{color:"#032F62"},children:" improves."})]})]})})}),"\n",n(t.p,{children:"This isn't about being strict for the sake of it—it's about maintaining confidence in your codebase. When coverage drops, it's a signal that code was added without thinking through edge cases."}),"\n",n(t.h3,{children:"Enforcing Test-First Development"}),"\n",n(t.p,{children:'The pre-push hook enforces what we call the "TDD Checklist":'}),"\n",a(t.ol,{children:["\n",n(t.li,{children:"✅ Tests exist for the feature/fix"}),"\n",n(t.li,{children:"✅ Tests fail before implementation (proves they test something real)"}),"\n",n(t.li,{children:"✅ Tests pass after implementation"}),"\n",n(t.li,{children:"✅ Coverage stays above 80%"}),"\n"]}),"\n",n(t.p,{children:"This workflow is now automatic. You literally can't skip it, because Git won't let you push."}),"\n",n(t.h3,{children:"TDD Impact"}),"\n",a(t.p,{children:["Since adding TDD enforcement, bug detection has shifted left—issues are caught before code review, not in production. The numbers are in ",n(t.a,{href:"#the-impact",children:"The Impact"})," below."]}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Confidence"})," in refactoring—comprehensive tests act as safety nets"]}),"\n"]}),"\n",a(t.p,{children:["The best part? Developers aren't complaining. They're relieved. Nobody ",n(t.em,{children:"wants"})," to push broken code; they just forget to run tests sometimes. Now Git reminds them."]}),"\n",a(t.blockquote,{children:["\n",a(t.p,{children:[n(t.strong,{children:"💡 Key Insight"}),": The 80% coverage rule isn't about hitting a number—it's about enforcing a mindset. When you can't push without tests, you start writing tests ",n(t.em,{children:"first"})," because that's faster than writing code and then scrambling to add tests later. The constraint creates the habit."]}),"\n"]}),"\n",n(t.h2,{children:"AI-First Development with Claude Code"}),"\n",n(t.p,{children:"The second major evolution of RaftStack is its deep integration with Claude Code, Anthropic's official CLI for AI-assisted development."}),"\n",n(t.h3,{children:"The Seven Skills"}),"\n",a(t.p,{children:["When you run ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"raftstack init"})})})}),", it bundles ",n(t.strong,{children:"7 domain-specific AI skills"})," that give Claude Code deep knowledge of RaftLabs coding standards:"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"mermaid","data-theme":"github-light",children:a(t.code,{"data-language":"mermaid","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"flowchart TB"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph Skills["🎯 AI Skills Layer"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S1[⚛️ React 19+
SOLID components, hooks, performance]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S2[🔧 Backend/Lambda
Clean architecture, Hono, Express]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S3[🗄️ Database/Drizzle
PostgreSQL schemas, indexing]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S4[🔍 SEO
Metadata, OpenGraph, JSON-LD]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S5[✨ Code Quality
30-line functions, naming, simplicity]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S6[🧪 TDD
Test-first methodology]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" S7[📋 Asana
Task integration]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph Commands["⚡ Slash Commands"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' C1["⌘ /shape"] -.->|"Plans features"| Plan'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' C2["⌘ /discover"] -.->|"Extracts patterns"| Standards'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' C3["⌘ /inject"] -.->|"Surfaces context"| Context'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' C4["⌘ /init-context"] -.->|"Creates project docs"| Constitution'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' subgraph Output["📄 Generated Artifacts"]'})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Plan[Feature Specifications]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Standards[.claude/standards/]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Context[Relevant Skills]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" Constitution[constitution.md]"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" end"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:' Skills -.->|"Power"| Commands'})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style Skills fill:#8b5cf6"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style Commands fill:#3b82f6"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" style Output fill:#10b981"})})]})})}),"\n",n(t.h3,{children:"How Skills Work"}),"\n",n(t.p,{children:'Think of skills as "expert knowledge modules" that Claude Code automatically loads when relevant. For example:'}),"\n",a(t.p,{children:[n(t.strong,{children:"When writing a React component"}),", the ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"react.md"})})})})," skill activates, reminding Claude about:"]}),"\n",a(t.ul,{children:["\n",a(t.li,{children:["React 19+ patterns (no more ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"React.FC"})})})}),")"]}),"\n",n(t.li,{children:"SOLID principles for component design"}),"\n",n(t.li,{children:"When to use Server vs Client components"}),"\n",n(t.li,{children:"Performance optimization strategies"}),"\n"]}),"\n",a(t.p,{children:[n(t.strong,{children:"When writing a Lambda function"}),", the ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"backend.md"})})})})," skill enforces:"]}),"\n",a(t.ul,{children:["\n",n(t.li,{children:"Clean architecture patterns"}),"\n",n(t.li,{children:"Proper error handling for serverless"}),"\n",n(t.li,{children:"Zod validation at API boundaries"}),"\n",n(t.li,{children:"Service layer separation"}),"\n"]}),"\n",n(t.p,{children:"These aren't just guidelines—they're active constraints that Claude Code follows during code generation."}),"\n",n(t.h4,{children:"Before vs After: React Component Generation"}),"\n",n(t.p,{children:n(t.strong,{children:"Without RaftStack skills:"})}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"tsx","data-theme":"github-light",children:a(t.code,{"data-language":"tsx","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"// Generic AI-generated component"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:"import"}),n(t.span,{style:{color:"#24292E"},children:" React "}),n(t.span,{style:{color:"#D73A49"},children:"from"}),n(t.span,{style:{color:"#032F62"},children:" 'react'"}),n(t.span,{style:{color:"#24292E"},children:";"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:"const"}),n(t.span,{style:{color:"#6F42C1"},children:" UserCard"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#6F42C1"},children:" React"}),n(t.span,{style:{color:"#24292E"},children:"."}),n(t.span,{style:{color:"#6F42C1"},children:"FC"}),n(t.span,{style:{color:"#24292E"},children:"<{ "}),n(t.span,{style:{color:"#E36209"},children:"user"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#005CC5"},children:" any"}),n(t.span,{style:{color:"#24292E"},children:" }> "}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#24292E"},children:" ({ "}),n(t.span,{style:{color:"#E36209"},children:"user"}),n(t.span,{style:{color:"#24292E"},children:" }) "}),n(t.span,{style:{color:"#D73A49"},children:"=>"}),n(t.span,{style:{color:"#24292E"},children:" {"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" const"}),n(t.span,{style:{color:"#24292E"},children:" ["}),n(t.span,{style:{color:"#005CC5"},children:"loading"}),n(t.span,{style:{color:"#24292E"},children:", "}),n(t.span,{style:{color:"#005CC5"},children:"setLoading"}),n(t.span,{style:{color:"#24292E"},children:"] "}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#24292E"},children:" React."}),n(t.span,{style:{color:"#6F42C1"},children:"useState"}),n(t.span,{style:{color:"#24292E"},children:"("}),n(t.span,{style:{color:"#005CC5"},children:"false"}),n(t.span,{style:{color:"#24292E"},children:");"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" const"}),n(t.span,{style:{color:"#6F42C1"},children:" handleClick"}),n(t.span,{style:{color:"#D73A49"},children:" ="}),n(t.span,{style:{color:"#24292E"},children:" () "}),n(t.span,{style:{color:"#D73A49"},children:"=>"}),n(t.span,{style:{color:"#24292E"},children:" {"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:" setLoading"}),n(t.span,{style:{color:"#24292E"},children:"("}),n(t.span,{style:{color:"#005CC5"},children:"true"}),n(t.span,{style:{color:"#24292E"},children:");"})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:" // ... 50 lines of mixed concerns"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:" setLoading"}),n(t.span,{style:{color:"#24292E"},children:"("}),n(t.span,{style:{color:"#005CC5"},children:"false"}),n(t.span,{style:{color:"#24292E"},children:");"})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" };"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" return"}),n(t.span,{style:{color:"#24292E"},children:" <"}),n(t.span,{style:{color:"#22863A"},children:"div"}),n(t.span,{style:{color:"#6F42C1"},children:" onClick"}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#24292E"},children:"{handleClick}>{user.name};"})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"};"})})]})})}),"\n",n(t.p,{children:n(t.strong,{children:"With RaftStack skills:"})}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"tsx","data-theme":"github-light",children:a(t.code,{"data-language":"tsx","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"// RaftLabs-standard component"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:"interface"}),n(t.span,{style:{color:"#6F42C1"},children:" UserCardProps"}),n(t.span,{style:{color:"#24292E"},children:" {"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#E36209"},children:" user"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#6F42C1"},children:" User"}),n(t.span,{style:{color:"#24292E"},children:"; "}),n(t.span,{style:{color:"#6A737D"},children:"// Typed, not `any`"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:" onSelect"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#24292E"},children:" ("}),n(t.span,{style:{color:"#E36209"},children:"id"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#005CC5"},children:" string"}),n(t.span,{style:{color:"#24292E"},children:") "}),n(t.span,{style:{color:"#D73A49"},children:"=>"}),n(t.span,{style:{color:"#6F42C1"},children:" Promise"}),n(t.span,{style:{color:"#24292E"},children:"<"}),n(t.span,{style:{color:"#005CC5"},children:"void"}),n(t.span,{style:{color:"#24292E"},children:">;"})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"}"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"// No React.FC (React 19+ pattern)"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:"export"}),n(t.span,{style:{color:"#D73A49"},children:" function"}),n(t.span,{style:{color:"#6F42C1"},children:" UserCard"}),n(t.span,{style:{color:"#24292E"},children:"({ "}),n(t.span,{style:{color:"#E36209"},children:"user"}),n(t.span,{style:{color:"#24292E"},children:", "}),n(t.span,{style:{color:"#E36209"},children:"onSelect"}),n(t.span,{style:{color:"#24292E"},children:" }"}),n(t.span,{style:{color:"#D73A49"},children:":"}),n(t.span,{style:{color:"#6F42C1"},children:" UserCardProps"}),n(t.span,{style:{color:"#24292E"},children:") {"})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" const"}),n(t.span,{style:{color:"#24292E"},children:" ["}),n(t.span,{style:{color:"#005CC5"},children:"isLoading"}),n(t.span,{style:{color:"#24292E"},children:", "}),n(t.span,{style:{color:"#005CC5"},children:"setIsLoading"}),n(t.span,{style:{color:"#24292E"},children:"] "}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#6F42C1"},children:" useState"}),n(t.span,{style:{color:"#24292E"},children:"("}),n(t.span,{style:{color:"#005CC5"},children:"false"}),n(t.span,{style:{color:"#24292E"},children:");"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:" // Extracted to custom hook for reusability"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" const"}),n(t.span,{style:{color:"#24292E"},children:" { "}),n(t.span,{style:{color:"#005CC5"},children:"handleSelect"}),n(t.span,{style:{color:"#24292E"},children:" } "}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#6F42C1"},children:" useUserSelection"}),n(t.span,{style:{color:"#24292E"},children:"(user.id, onSelect);"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#D73A49"},children:" return"}),n(t.span,{style:{color:"#24292E"},children:" ("})]}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#24292E"},children:" <"}),n(t.span,{style:{color:"#22863A"},children:"button"}),n(t.span,{style:{color:"#6F42C1"},children:" onClick"}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#24292E"},children:"{handleSelect} "}),n(t.span,{style:{color:"#6F42C1"},children:"disabled"}),n(t.span,{style:{color:"#D73A49"},children:"="}),n(t.span,{style:{color:"#24292E"},children:"{isLoading}>"})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" {user.name}"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#24292E"},children:" "})]}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:" );"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#24292E"},children:"}"})})]})})}),"\n",n(t.p,{children:"The difference? The skill enforces:"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:["No ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"React.FC"})})})})," (React 19+ convention)"]}),"\n",a(t.li,{children:["Strict typing (no ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"any"})})})}),")"]}),"\n",n(t.li,{children:"Single responsibility (selection logic extracted to hook)"}),"\n",a(t.li,{children:["Semantic HTML (",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"button"})})})})," not ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"div"})})})})," for clickable elements)"]}),"\n"]}),"\n",n(t.h3,{children:"The Planning Protocol"}),"\n",a(t.p,{children:["Perhaps the most powerful workflow is the ",n(t.strong,{children:"planning protocol"}),", enforced through the ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/shape"})})})})," command and ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"_planning-protocol"})})})})," skill:"]}),"\n",a(t.p,{children:[n(t.strong,{children:"Before writing any feature code"}),", Claude Code must:"]}),"\n",a(t.ol,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Understand the problem"})," - Clarify requirements through questions"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Explore existing patterns"})," - Search the codebase for similar implementations"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Design the solution"})," - Create a step-by-step implementation plan"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Get approval"})," - Present the plan to you for sign-off"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Execute with checkpoints"})," - Implement with regular verification"]}),"\n"]}),"\n",n(t.p,{children:'This prevents the "AI hallucination" problem where Claude starts writing code before understanding your codebase. It forces deliberate planning before implementation.'}),"\n",n(t.h3,{children:"The Shape Command: Adaptive Depth"}),"\n",a(t.p,{children:["The ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/shape"})})})})," command adapts to task complexity:"]}),"\n",a(t.p,{children:[n(t.strong,{children:"Quick Flow"})," (1-2 file changes):"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/shape"}),n(t.span,{style:{color:"#032F62"},children:' "add a loading spinner to the button"'})]})})})}),"\n",n(t.p,{children:"→ Minimal planning, fast implementation"}),"\n",a(t.p,{children:[n(t.strong,{children:"Light Spec"})," (3-5 files, single feature):"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/shape"}),n(t.span,{style:{color:"#032F62"},children:' "add user authentication"'})]})})})}),"\n",n(t.p,{children:"→ Brief spec, identifies key files, then implements"}),"\n",a(t.p,{children:[n(t.strong,{children:"Full Spec"})," (6+ files, architectural changes):"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/shape"}),n(t.span,{style:{color:"#032F62"},children:' "migrate from REST to tRPC"'})]})})})}),"\n",n(t.p,{children:"→ Comprehensive planning, architecture review, approval gate"}),"\n",n(t.p,{children:"The deeper the change, the more Claude Code forces you to think through the design before touching code."}),"\n",n(t.h3,{children:"Slash Commands in Action"}),"\n",n(t.p,{children:"Here are the 8 commands bundled with RaftStack:"}),"\n",a(t.table,{children:[n(t.thead,{children:a(t.tr,{children:[n(t.th,{children:"Command"}),n(t.th,{children:"Purpose"})]})}),a(t.tbody,{children:[a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/shape"})})})})}),n(t.td,{children:"Plan and implement features with adaptive depth"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/discover"})})})})}),a(t.td,{children:["Extract coding patterns from existing code → ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:".claude/standards/"})})})})]})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/inject"})})})})}),n(t.td,{children:"Surface relevant skills/context based on current task"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/init-context"})})})})}),n(t.td,{children:"Create project constitution (vision, standards, architecture)"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/index"})})})})}),n(t.td,{children:"Index and organize discovered standards"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/migrate-configs"})})})})}),n(t.td,{children:"Migrate monorepo configs to shared packages"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/help"})})})})}),n(t.td,{children:"Interactive guide to all RaftStack features"})]}),a(t.tr,{children:[n(t.td,{children:n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/raftstack/_planning-protocol"})})})})}),n(t.td,{children:"Enforce approval gates before implementation"})]})]})]}),"\n",a(t.p,{children:['These commands turn Claude Code from a "smart autocomplete" into a ',n(t.strong,{children:"structured development partner"})," that follows your team's conventions automatically."]}),"\n",n(t.h3,{children:"Real Example: Shaping a Feature"}),"\n",a(t.p,{children:["Here's what happens when you run ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:'/raftstack/shape "add pagination to the users table"'})})})}),":"]}),"\n",a(t.ol,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Claude analyzes"})," your codebase to find existing pagination patterns"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Asks clarifying questions"}),': "Should this be cursor-based or offset pagination?"']}),"\n",a(t.li,{children:[n(t.strong,{children:"Creates a spec"}),":","\n",a(t.ul,{children:["\n",a(t.li,{children:["Files to modify: ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"src/components/UsersTable.tsx"})})})}),", ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"src/api/users.ts"})})})})]}),"\n",a(t.li,{children:["New types: ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"PaginationParams"})})})}),", ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"PaginatedResponse"})})})})]}),"\n",n(t.li,{children:"Testing strategy: Unit tests for API, integration test for UI"}),"\n"]}),"\n"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Presents the plan"})," for your approval"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Executes step-by-step"})," with test-driven development"]}),"\n"]}),"\n",a(t.p,{children:["You get to review the architecture ",n(t.em,{children:"before"})," Claude writes hundreds of lines of code. This prevents wasted work and ensures consistency with your codebase."]}),"\n",a(t.blockquote,{children:["\n",a(t.p,{children:[n(t.strong,{children:"💡 Key Insight"}),": AI tools are incredibly powerful at writing code, but terrible at choosing ",n(t.em,{children:"what"})," to write. The planning protocol inverts this: you guide the architecture, Claude handles the implementation. This is the division of labor that actually works."]}),"\n"]}),"\n",n(t.h3,{children:"Installing Skills Without Full Setup"}),"\n",a(t.p,{children:["In v1.10.1, we added the ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"install-commands"})})})})," command for projects that already have RaftStack but want to update their skills:"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" install-commands"})]})})})}),"\n",a(t.p,{children:["This updates ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:".claude/skills/"})})})})," and ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:".claude/commands/"})})})})," without touching your existing Git hooks or configs. Perfect for staying up-to-date as we add new skills and commands."]}),"\n",n(t.h2,{children:"The Bigger Picture: A Complete Development Framework"}),"\n",n(t.p,{children:"RaftStack isn't meant to work alone. It's part of a comprehensive project setup workflow that our senior engineers collaboratively developed:"}),"\n",a(t.ol,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Tech Lead Consultation"})," — Discuss and document stack decisions before writing any code"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Repository Initialization"})," — Use Better-T-Stack, Turborepo, or AWS Amplify based on project needs"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Organization Standards"})," — Run ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"@raftlabs/raftstack init"})})})})]}),"\n",a(t.li,{children:[n(t.strong,{children:"Environment Management"})," — Secure environment variables with EnvX encryption"]}),"\n",a(t.li,{children:[n(t.strong,{children:"AI Development Setup"})," — Initialize Claude Code with bundled skills for consistent AI-assisted development"]}),"\n"]}),"\n",n(t.p,{children:"This framework gives every engineer a clear, proven path from zero to productive. It's not about restricting creativity—it's about eliminating the boring parts so engineers can focus on solving interesting problems for our clients."}),"\n",n(t.h2,{children:"Metrics: Measuring What Matters"}),"\n",a(t.p,{children:["The CLI includes a ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"metrics"})})})})," command that helps teams understand their repository health:"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:n(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" metrics"})]})})})}),"\n",n(t.p,{children:"This shows:"}),"\n",a(t.ul,{children:["\n",n(t.li,{children:"Percentage of commits following Conventional Commits"}),"\n",n(t.li,{children:"Branch naming compliance"}),"\n",n(t.li,{children:"Files that would fail lint checks"}),"\n",n(t.li,{children:'Overall "health score" for the repository'}),"\n"]}),"\n",n(t.p,{children:"This isn't about policing—it's about visibility. Teams can see where they stand and track improvement over time. It's been particularly useful for onboarding new team members to existing projects, giving them instant insight into the codebase conventions."}),"\n",n(t.h2,{children:"The Impact"}),"\n",n(t.p,{children:"After rolling this out organization-wide (v1.0 in January 2026, v1.10 in February 2026), we've seen:"}),"\n",n(t.h3,{children:"Efficiency Gains"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Project setup time"}),": 2-3 days → 20 seconds"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Commit message quality"}),": Drastically improved, with clear history across all projects"]}),"\n",a(t.li,{children:[n(t.strong,{children:"PR review time"}),": Reduced because changes are smaller and better documented"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Onboarding time"}),": New engineers get productive faster because every project works the same way"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Code review friction"}),": Eliminated debates about formatting—it's all automated"]}),"\n"]}),"\n",n(t.h3,{children:"Quality Improvements (v1.10+)"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Test coverage"}),": 72% → 87% average across projects"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Broken builds pushed to main"}),": ~2-3 per week → 0 in the last 2 months"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Time to detect bugs"}),": Shifted left—caught before code review instead of in production"]}),"\n",a(t.li,{children:[n(t.strong,{children:"AI-generated code quality"}),": Skills enforce RaftLabs patterns automatically"]}),"\n"]}),"\n",n(t.h3,{children:"Developer Experience"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Confidence in refactoring"}),": Comprehensive tests act as safety nets"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Consistency across projects"}),": Every repo follows the same patterns"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Planning quality"}),": ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/shape"})})})})," command forces deliberate design before implementation"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Context retention"}),": ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:".claude/standards/"})})})})," captures institutional knowledge"]}),"\n"]}),"\n",a(t.p,{children:["But the biggest win? ",n(t.strong,{children:"Confidence"}),". When I look at any RaftLabs repository now, I know exactly what I'll find. The same hooks, the same commit format, the same branch naming, the same PR templates, the same test coverage standards, and the same AI-enforced coding patterns. It just works."]}),"\n",n(t.h2,{children:"Try It Yourself"}),"\n",n(t.p,{children:"RaftStack is published on npm and works with any TypeScript project:"}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:a(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Full setup: Git hooks, commit standards, AI skills"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" init"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Update Claude Code skills only (for existing RaftStack projects)"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" install-commands"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Setup GitHub branch protection rules"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" setup-protection"})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Check repository compliance & test coverage"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"pnpm"}),n(t.span,{style:{color:"#032F62"},children:" dlx"}),n(t.span,{style:{color:"#032F62"},children:" @raftlabs/raftstack"}),n(t.span,{style:{color:"#032F62"},children:" metrics"})]})]})})}),"\n",a(t.p,{children:["Full documentation is on the ",n(t.a,{href:"https://www.npmjs.com/package/@raftlabs/raftstack",children:"npm package page"}),"."]}),"\n",n(t.h3,{children:"Using Claude Code Skills"}),"\n",a(t.p,{children:["Once installed, use the skills in ",n(t.a,{href:"https://claude.ai/code",children:"Claude Code"}),":"]}),"\n",n(t.figure,{"data-rehype-pretty-code-figure":"",children:n(t.pre,{style:{backgroundColor:"#fff",color:"#24292e"},tabIndex:"0","data-language":"bash","data-theme":"github-light",children:a(t.code,{"data-language":"bash","data-theme":"github-light",style:{display:"grid"},children:[n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Plan a feature with adaptive depth"})}),"\n",a(t.span,{"data-line":"",children:[n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/shape"}),n(t.span,{style:{color:"#032F62"},children:' "add real-time notifications"'})]}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Extract patterns from your codebase"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/discover"})}),"\n",n(t.span,{"data-line":"",children:" "}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6A737D"},children:"# Initialize project context for AI"})}),"\n",n(t.span,{"data-line":"",children:n(t.span,{style:{color:"#6F42C1"},children:"/raftstack/init-context"})})]})})}),"\n",n(t.p,{children:"The skills work seamlessly—Claude Code automatically applies RaftLabs standards to any code it generates."}),"\n",n(t.hr,{}),"\n",n(t.h2,{children:"What's Next"}),"\n",n(t.p,{children:"RaftStack continues to evolve. Here's what's on the roadmap:"}),"\n",a(t.ul,{children:["\n",a(t.li,{children:[n(t.strong,{children:"Monorepo config migration"})," - Standardize shared ESLint/TypeScript configs across workspaces"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Enhanced metrics"})," - Visualize test coverage trends over time"]}),"\n",a(t.li,{children:[n(t.strong,{children:"Custom skill templates"})," - Let teams define their own domain-specific skills"]}),"\n",a(t.li,{children:[n(t.strong,{children:"IDE integrations"})," - VS Code extension for instant access to ",n(t.span,{"data-rehype-pretty-code-figure":"",children:n(t.code,{"data-language":"plaintext","data-theme":"github-light",style:{backgroundColor:"#fff",color:"#24292e"},children:n(t.span,{"data-line":"",children:n(t.span,{children:"/shape"})})})})," and other commands"]}),"\n"]}),"\n",n(t.hr,{}),"\n",a(t.p,{children:["Building developer tools that save time is satisfying, but building tools that improve ",n(t.em,{children:"quality"})," across an entire organization? That's a different level of impact."]}),"\n",n(t.p,{children:"I'm grateful to work at a company that values engineering excellence enough to invest in internal tooling. RaftLabs gave me the time and trust to build something that benefits every engineer and every client project we deliver."}),"\n",n(t.p,{children:"If your team is growing and noticing similar coordination challenges, consider whether better tooling might help. It's not about discipline—it's about making the right thing the easy thing. And in 2026, \"the right thing\" includes AI that understands your team's standards, Git hooks that enforce test coverage, and a 20-second setup that makes excellence automatic."}),"\n",n(t.p,{children:"Sometimes the best code you write is the code that writes code. And sometimes the best tool you build is the one that makes it impossible to ship bad code."})]})}return{default:function(e={}){const{wrapper:a}=e.components||{};return a?n(a,{...e,children:n(_createMdxContent,{...e})}):_createMdxContent(e)}};

All articles(1)

Building RaftStack: How a CLI Transformed Our Development Workflow