# Scaffold

- [New Project Docs](/docs/overview): This docs set is the canonical starting point for a new Howells project.
- [Principles](/docs/principles): The development philosophy behind the Scaffold Baseline.
- [Getting Started](/docs/getting-started): Use this sequence when creating a new repo.
- Reference
  - [Stack Decisions](/docs/reference/stack-decisions): These are the current default decisions for new TypeScript product work and shared config repos.
  - [Architecture Defaults](/docs/reference/architecture-defaults): These are the recurring architecture choices across your active repos.
  - [Repo Archetypes](/docs/reference/repo-archetypes): Most new repos should start from one of these shapes.
  - [Package Boundaries](/docs/reference/package-boundaries): These are the package boundaries that keep recurring across your serious monorepos.
  - [Deployment Defaults](/docs/reference/deployment-defaults): This is the default deployment logic inferred from your active repos.
  - [Default Dependencies](/docs/reference/default-dependencies): This is the package baseline inferred from recent active repos.
  - [Config Snippets](/docs/reference/config-snippets): These are the canonical starting snippets for a new repo.
  - [UI Projects](/docs/reference/ui-projects): For new UI-based projects, the default is a local UI package seeded from the scaffold's bundled UI baseline.
  - UI Baseline
    - [Bundled UI Baseline](/docs/reference/ui-baseline): This directory vendors the deleted UI-system files recovered from the old `~/Sites/patternmode` history at commit `1ffeb6ddb9d5d449a3618f3b73f79b93590cd463^`.
  - [Shared Package Candidates](/docs/reference/shared-package-candidates): This section separates packages that are already real shared assets from patterns that look ready to become them.
  - [Agent Workflow](/docs/reference/agent-workflow): This is the baseline for repos that will be worked on with coding assistants, Arc, and reusable specialist skills. Claude Code is served natively by the skill directory, Codex through a platform wrapper, and a Cursor surface is deferred future work.
  - [Agentic Development](/docs/reference/agentic-development): Use this reference when a repo is not just calling a model, but exposing agent-facing behavior, agent-owned tools, workflows, memory, traces, MCP, or long-running AI jobs.
  - [Launch Checklist](/docs/reference/launch-checklist): Use this when starting a new repo or standardizing an existing one.
- ADR
  - [Agent Skill Packaging](/docs/adr/0001-agent-skill-packaging): Scaffold's Project Docs should remain the source of truth, with one agent skill distribution surface exposed to Codex, Claude Code, and Cursor through platform-specific Skill Wrappers. This keeps the Scaffold Baseline coherent across supported coding assistants while still allowing each platform to use its own metadata, command, rules, or install conventions.
  - [Scaffold Repo Deviations](/docs/adr/0002-scaffold-repo-deviations): The scaffold repository deliberately deviates from its own published baseline because it is a single-app documentation site, not a product monorepo. It drops the workspace, orchestration, hook, and test machinery the baseline assumes, and gates on a static build instead of a test suite. Getting Started step 8 asks every repo to record intentional deviations early; this ADR is scaffold's own record.