# AILoadout manifest — full-stack-dev
# Upload this file to your AI, then say: Use this Loadout and start at workflow step 1.
schema_version: "1.0"
kind: "Loadout"
id: "full-stack-dev"
title: "Full-Stack Development (React + TypeScript)"
version: "1.0.0"
category: "Coding"
purpose: "A complete AI-assisted workflow for React and TypeScript features — from planning and implementation through review, tests, and pull requests."
expected_outcome:
  - "Ship features faster with fewer defects"
  - "Keep implementation consistent across the team"
  - "Automate review and test preparation"
  - "Generate complete documentation and pull-request notes"
supported_platforms:
  - "claude-code"
  - "cursor"
  - "windsurf"
  - "cline"
  - "vscode"
  - "codex"
  - "claude"
  - "chatgpt"
prerequisites:
  - "A GitHub account and Personal Access Token for GitHub MCP"
  - "Node.js for npx"
  - "The React and TypeScript project you want to work on"
resources:
  prompt:
    - id: "prompt-feature"
      name: "Feature Implementation"
      description: "Have the AI implement a feature spec-first — summarize the spec, ask about unclear points, plan files, then build."
      source:
        kind: "inline"
      content: |-
        You are a senior full-stack dev.
        When I request a feature, follow this order:
        1. Summarize the spec briefly + ask about anything unclear
        2. List the files you'll touch
        3. Write code file by file following project standards
        4. Suggest the tests that should exist
  rule:
    - id: "rule-react-ts"
      name: "React + TypeScript Standards"
      description: "Standards the AI must follow — strict types, no any, clear names, small reusable components."
      source:
        kind: "inline"
      content: |-
        - Always use TypeScript strict; never use any
        - Functional components + hooks only
        - Name props/variables meaningfully
        - Keep components small and reusable
        - Always handle error + loading states
  agent:
    - id: "agent-code-review"
      name: "Code Reviewer"
      description: "A subagent that reviews code in its own context, finds bugs/vulnerabilities, and reports back — without cluttering the main chat."
      source:
        kind: "github"
        ref: "anthropics/claude-code subagents"
        url: "https://docs.claude.com/en/docs/claude-code/sub-agents"
      note: "ℹ️ Place as a file in .claude/agents/ — fully supported on Claude Code (other platforms can use a prompt/skill instead)"
  mcp:
    - id: "mcp-context7"
      name: "Context7"
      description: "Pull the latest library documentation for the AI to reference while coding — reduces API guesswork."
      source:
        kind: "registry"
        ref: "upstash/context7"
        url: "https://github.com/upstash/context7"
      install: "npx -y @upstash/context7-mcp"
    - id: "mcp-filesystem2"
      name: "Filesystem"
      description: "Let the AI read/write files in your project directly."
      source:
        kind: "registry"
        ref: "@modelcontextprotocol/server-filesystem"
        url: "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem"
      install: "npx -y @modelcontextprotocol/server-filesystem ."
    - id: "mcp-github"
      name: "GitHub"
      description: "Search code, read issues/PRs, and open PRs through the AI."
      source:
        kind: "registry"
        ref: "github/github-mcp-server"
        url: "https://github.com/github/github-mcp-server"
  template:
    - id: "template-pr"
      name: "PR Description"
      description: "A pull-request description template the AI fills in automatically."
      source:
        kind: "inline"
      content: |-
        ## What
        <summary of changes>
        ## Why
        <reason / issue>
        ## How to test
        1. ...
        2. ...
workflow:
  - step: "Plan"
    order: 1
    estimated_time: "~5 min"
    ai_actions:
      - "Summarize the feature spec from what you said"
      - "Ask about anything unclear"
      - "Propose the files to touch"
    user_action: "Describe the feature + confirm the spec"
    uses:
      - "prompt-feature"
    done_when: "A 3–5 line spec + the files to touch"
    tip: "Don't rush the AI into coding before the spec is settled"
  - step: "Scaffold"
    order: 2
    estimated_time: "~5 min"
    ai_actions:
      - "Use Filesystem to read the current project structure"
      - "Create files/folders per the spec"
    user_action: "Confirm the structure before continuing"
    uses:
      - "mcp-filesystem2"
      - "rule-react-ts"
    done_when: "Files in place per the spec"
    tip: "Let the Rule apply from now so file names stay standard"
  - step: "Implement"
    order: 3
    estimated_time: "20–40 min"
    ai_actions:
      - "Write code file by file to standard"
      - "Use Context7 to check the library's latest API"
    user_action: "Review each file before the next"
    uses:
      - "prompt-feature"
      - "rule-react-ts"
      - "mcp-context7"
    done_when: "The feature works end to end"
    tip: "AI guessing an API? Tell it 'check with Context7 first'"
  - step: "Review"
    order: 4
    estimated_time: "~10 min"
    ai_actions:
      - "Call the Code Reviewer subagent to review the new code in a separate context"
      - "Report issues ranked by severity"
    user_action: "Work through what the reviewer flags"
    uses:
      - "agent-code-review"
    done_when: "No serious bugs left"
    tip: "Keeping the reviewer in a separate context surfaces more blind spots"
  - step: "Write tests"
    order: 5
    estimated_time: "~10 min"
    ai_actions:
      - "Write tests for the main paths + edge cases"
      - "Run the tests"
    user_action: "Make sure they all pass"
    uses:
      - "prompt-feature"
      - "rule-react-ts"
    done_when: "All tests pass"
    tip: "Write tests after review so you test what's already correct"
  - step: "Open PR"
    order: 6
    estimated_time: "~5 min"
    ai_actions:
      - "Fill the PR Description from the real diff"
      - "Use GitHub to open the PR"
    user_action: "Check the description + test steps before sending"
    uses:
      - "template-pr"
      - "mcp-github"
    done_when: "PR opened, with test instructions"
    tip: "Detailed How-to-test = faster reviewer approval"
creator:
  name: "AILoadout"
  handle: "@ailoadout"
metadata:
  version: "1.0.0"
  updated_at: "2026-07-22"
  license: "MIT"
