# Scaffold

- [Overview](/docs/overview): Howells defaults for repo shape, stack, package boundaries, agent workflow, and launch checks.
- [Principles](/docs/principles): Howells development principles: strict types, enforced boundaries, and one source of truth.
- [Getting started](/docs/getting-started): Set up a repo, choose its archetype, wire config, enforce boundaries, and record deviations.
- Reference
  - [Stack decisions](/docs/reference/stack-decisions): The current default stack for new TypeScript product and config work: Next.js, Drizzle, Neon, typed boundaries chosen by consumer shape, and the pinned toolchain.
  - [Stack in practice](/docs/reference/stack-in-practice): Services, packages, and tools measured across active repos.
  - [Neon](/docs/reference/neon): Neon failure modes, the shared client configuration, and the July 2026 repo survey.
  - [Architecture defaults](/docs/reference/architecture-defaults): The recurring architecture choices across my active repos: a domain core, thin app clients, typed boundaries, and where orchestration lives.
  - [Repo archetypes](/docs/reference/repo-archetypes): The handful of repo shapes most new projects start from, from a single-purpose tool to a full product monorepo, and how to pick between them.
  - [Package boundaries](/docs/reference/package-boundaries): The package boundaries my monorepos keep converging on: apps never import apps, shared code crosses explicit seams, direction enforced by tooling.
  - [Deployment defaults](/docs/reference/deployment-defaults): Vercel targets, environment checks, preview and production rules, and release gates.
  - [Default dependencies](/docs/reference/default-dependencies): Package defaults for framework, data, lint, config, and AI work.
  - [Config snippets](/docs/reference/config-snippets): Starting config for Turbo, TypeScript, linting, and shared root scripts.
  - [UI projects](/docs/reference/ui-projects): The local UI package baseline: Tailwind v4, Base UI, design tokens, motion, and Storybook.
  - UI Baseline
    - [Bundled UI baseline](/docs/reference/ui-baseline): Source shapes for shared components, tokens, motion, transitions, and Storybook.
  - [Shared package candidates](/docs/reference/shared-package-candidates): Which shared packages are established, which remain candidates, and when to extract one.
  - [Agent workflow](/docs/reference/agent-workflow): How agents work in a repo: local rules, shared skills, root commands, Git, and progress records.
  - [Development skills](/docs/reference/development-skills): How to route development work through the installed engineering, specialist, and stack-specific skills.
  - [Worktree coordination](/docs/reference/worktree-coordination): The machine-wide worktree policy shared by Codex, Claude Code, their account profiles, and manual Git work.
  - [Agentic development](/docs/reference/agentic-development): The reference for repos that expose agent-facing behavior: agent-owned tools, workflows, memory, traces, MCP, and long-running AI jobs.
  - [Launch checklist](/docs/reference/launch-checklist): Checks for config, boundaries, environment, deployment, and agent surfaces before release.
- ADR
  - [Agent skill packaging](/docs/adr/0001-agent-skill-packaging): Why Scaffold has one canonical documentation tree and thin platform wrappers.
  - [Scaffold repo deviations](/docs/adr/0002-scaffold-repo-deviations): Why this single-app documentation site omits parts of the product baseline.