# Inceptor > Issue-driven web template: a governed, agent-orchestrated way of building — issue → Claude Code → PR → merge → deploy — on Astro 5 + React 19 islands, with quality and ethics gates enforced by the repo. Source: https://github.com/ArtemioPadilla/inceptor (MIT). Agent/contributor context lives in [CLAUDE.md](https://github.com/ArtemioPadilla/inceptor/blob/main/CLAUDE.md) — the sub-agent loop (prometeo → forja → centinela), conventions and guardrails. Full docs as a single file: [llms-full.txt](https://artemiop.com/inceptor/llms-full.txt). ## Start here - [How a feature ships — live walkthrough](https://artemiop.com/inceptor/how-it-works/): the issue → plan → commits → verdict loop on a real run - [Component gallery](https://artemiop.com/inceptor/gallery/): every component rendered live, light + dark, with Props API tables - [Demos](https://artemiop.com/inceptor/demos/): dashboard, 50k-row virtualized table, settings, backend API contract ## Docs - [Adding a component](https://artemiop.com/inceptor/docs/building/adding-a-component/): Two paths: shadcn CLI for primitive-free, hand-write for interactive Base UI. - [Self-hosted backend](https://artemiop.com/inceptor/docs/building/backend/): The opt-in backend archetypes (Node/Hono + Flask/Pydantic): one /api contract, two runtimes, zero impact on the static deploy. - [The compound-component gotcha](https://artemiop.com/inceptor/docs/building/compound-components/): Why Dialog and Tabs must live in one island. - [Hydration directives](https://artemiop.com/inceptor/docs/building/hydration/): client:load vs idle vs visible vs media vs only. - [Testing — Vitest + Playwright](https://artemiop.com/inceptor/docs/building/testing/): Unit tests with Vitest, visual regression with Playwright. - [Theming & dark mode](https://artemiop.com/inceptor/docs/building/theming/): Two-layer CSS-var model + class-based dark variant. - [Visual regression](https://artemiop.com/inceptor/docs/building/visual-regression/): Playwright snapshots in CI, refresh in matching Linux env. - [0001 — Shape Up over Scrum for solo + AI development](https://artemiop.com/inceptor/docs/decisions/0001-shape-up-over-scrum/): Architecture Decision Record. - [0002 — Base UI over Radix UI for shadcn primitives](https://artemiop.com/inceptor/docs/decisions/0002-base-ui-over-radix/): Architecture Decision Record. - [0003 — Centinela verdict tokens for orchestrator routing](https://artemiop.com/inceptor/docs/decisions/0003-centinela-verdict-tokens/): Architecture Decision Record. - [0003 — Astro Starlight for the docs site](https://artemiop.com/inceptor/docs/decisions/0003-starlight-for-docs/): Architecture Decision Record. - [0004 — Custom /docs route over Astro Starlight](https://artemiop.com/inceptor/docs/decisions/0004-custom-docs-route/): Architecture Decision Record. - [0005 — Base UI as the standard component library](https://artemiop.com/inceptor/docs/decisions/0005-base-ui-component-library/): Architecture Decision Record. - [NNNN — ](https://artemiop.com/inceptor/docs/decisions/template/): Architecture Decision Record. - [The 8-item ethics checklist](https://artemiop.com/inceptor/docs/ethics-ux/checklist/): Tiered ethics gate every UI PR passes. - [Persuasive-tech framework](https://artemiop.com/inceptor/docs/ethics-ux/framework/): Fogg's Functional Triad applied to this scaffold. - [UX quality bar (7 criteria)](https://artemiop.com/inceptor/docs/ethics-ux/quality-bar/): Measurable thresholds gated in CI. - [Stakeholder Analysis for risk:high](https://artemiop.com/inceptor/docs/ethics-ux/stakeholder-analysis/): 7-step audit for highest-risk PRs. - [Integration plan (v1.0)](https://artemiop.com/inceptor/docs/history/integration-plan/): Historical record of the 27-issue rollout that bootstrapped this scaffold. - [Roadmap](https://artemiop.com/inceptor/docs/history/roadmap/): Open epics and planned work. - [Inceptor](https://artemiop.com/inceptor/docs/how-we-work/inceptor/): Every feature ships as issue → PR → merge → deploy. - [The orchestration workflow](https://artemiop.com/inceptor/docs/how-we-work/orchestration/): How the main Claude Code session drives the Inceptor sub-agents. - [Shape Up cadence](https://artemiop.com/inceptor/docs/how-we-work/shape-up/): Pitches, appetites, cycles, cooldown. - [Spec-DD with Zod](https://artemiop.com/inceptor/docs/how-we-work/spec-dd/): Cross-boundary types live as Zod schemas, never as TypeScript interfaces. - [Sub-agents — prometeo, forja, centinela](https://artemiop.com/inceptor/docs/how-we-work/sub-agents/): The three agents that execute the Inceptor loop. - [TDD with commit trailers](https://artemiop.com/inceptor/docs/how-we-work/tdd/): Red → green → refactor, enforced via Tdd-Red commit trailers. - [Documentation](https://artemiop.com/inceptor/docs/): A personal scaffold for shipping zero-cost, static-first web apps — with methodology, ethics, and orchestration baked in. - [Patterns](https://artemiop.com/inceptor/docs/patterns/): How to build common product surfaces from Inceptor's primitives — the layer above components. - [Create flow pattern](https://artemiop.com/inceptor/docs/patterns/create-flow/): Single-page and multi-step resource creation, validated with Zod. - [Delete with confirmation](https://artemiop.com/inceptor/docs/patterns/delete-confirm/): Destructive actions, gated by friction proportional to the blast radius. - [Details page pattern](https://artemiop.com/inceptor/docs/patterns/details-page/): Read-only resource views — flat and tabbed. - [Listing pattern](https://artemiop.com/inceptor/docs/patterns/listing/): Filterable, sortable collections with honest empty and error states. - [Empty, error & loading states](https://artemiop.com/inceptor/docs/patterns/states/): The three non-happy states every data surface owes its users. - [Commands cheatsheet](https://artemiop.com/inceptor/docs/reference/commands/): Every npm script and shell helper, in one table. - [Environment variables](https://artemiop.com/inceptor/docs/reference/env-vars/): Secrets and feature flags the scaffold expects. - [File structure](https://artemiop.com/inceptor/docs/reference/file-structure/): What lives where in this scaffold. - [Forbidden imports](https://artemiop.com/inceptor/docs/stack/forbidden-imports/): Single source of truth for what this scaffold refuses to ship. - [Stack overview](https://artemiop.com/inceptor/docs/stack/overview/): Installed versions and architectural choices. - [The 60-second Inceptor tour](https://artemiop.com/inceptor/docs/start-here/inceptor-tour/): How a feature actually moves from idea to shipped in this scaffold. - [Quick start](https://artemiop.com/inceptor/docs/start-here/quick-start/): Get a working local copy of the scaffold in under five minutes. - [What you get](https://artemiop.com/inceptor/docs/start-here/what-you-get/): Feature inventory shipped with the scaffold. ## Blog - [The June 2026 audit: auditing ourselves with our own loop](https://artemiop.com/inceptor/blog/2026-06-june-audit/): What a full site audit found, what we fixed same-day, and what it says about the template's own methodology. - [Self-hosted backend archetypes: Hono + Flask, one OpenAPI contract](https://artemiop.com/inceptor/blog/2026-06-backend-archetypes/): How PR - [The component library epic: 44 components, 19 gallery categories](https://artemiop.com/inceptor/blog/2026-06-component-library-epic/): How we built a full shadcn-compatible UI library on Base UI primitives and shipped it in one sprint. - [Welcome to your blog](https://artemiop.com/inceptor/blog/welcome/): A starter post — replace with something real, or delete the blog if you don't need one.