ForgeKit

A monorepo starter paired with an AI-driven development workflow. Your AI assistant doesn't just write code — it understands your architecture, tracks decisions, and follows a structured plan across sessions.

What's in the box

Monorepo starter — React 19 + Vite, Hono API, TypeScript 5, Tailwind 4, Turborepo, pnpm workspaces, Vitest, ESLint, Prettier, Husky, Docker Compose for Postgres.

AI workflow layer — 11 skills (/kickstart, /plan-phase, /log-decision, /update-focus, etc.) mirrored across Claude Code, Cursor, and VS Code Copilot. Doc templates, knowledge base, and persistent session context so your assistant loads the full picture each time.

Obsidian-ready docs — All documentation lives in docs/ as an Obsidian vault with YAML frontmatter, [[wikilinks]], and graph view. Skills generate new docs in the same format, so every project you build from ForgeKit gets a live knowledge graph out of the box.

Quick start

# 1. Use this template on GitHub → create your repo → clone
git clone <your-repo-url>
cd <your-repo>
pnpm install

# 2. Environment
cp .env.example .env

# 3. Run
pnpm dev          # web :5173, api :3000
docker compose up -d  # optional: postgres :5432

Then in your AI assistant:

/kickstart    # generates docs/TECH_STACK.md, ARCHITECTURE_GUIDE.md,
              # DECISIONS.md, PRODUCTION_ROADMAP.md, phases/, CURRENT_FOCUS.md
/create-prd   # product requirements via guided discovery
/plan-phase 1 # detailed task breakdown for Phase 1
/start-session # loads project context at the start of each session

Open the docs as an Obsidian vault

Obsidian → Open folder as vault → <your-repo>/docs

The vault's home note is docs/_INDEX.md. Every generated doc is cross-linked with wikilinks and surfaces in graph view.

Project layout

├── apps/
│   ├── api/          # Hono API
│   └── web/          # React + Vite
├── packages/
│   ├── shared/       # Types, utils, constants
│   └── ui/           # Shared components
├── docs/             # ← Obsidian vault (open as vault root)
│   ├── _INDEX.md     # Home / Map of Content
│   ├── README.md     # Full project README (detailed quick start)
│   ├── FORGEKIT_METHODOLOGY.md  # Philosophy & workflow
│   ├── CURRENT_FOCUS.md         # Active work
│   ├── DECISIONS.md             # ADRs
│   ├── COMMANDS.md              # Skill reference
│   ├── STACK_MAP.md             # Tech reference
│   ├── templates/               # Doc templates used by /kickstart
│   └── phases/                  # Phase docs generated by /plan-phase
├── .claude/skills/   # Claude Code skills
├── .cursor/          # Cursor commands & prompts
└── .vscode/prompts/  # VS Code Copilot prompts

Learn more

Full README with detailed setup, troubleshooting, and skill walkthroughs: docs/README.md

Methodology (why it's built this way): docs/FORGEKIT_METHODOLOGY.md

Skills reference: docs/COMMANDS.md