Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,3 +18,7 @@ next-env.d.ts

# os
.DS_Store

# vendored skills (local-machine symlink, not portable)
.claude/skills
.agents/skills
24 changes: 8 additions & 16 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,11 @@ Guidance for AI coding agents working in this repository: tkodev-web-v5, the v5
## Read first, in order

@README.md
@docs/01-standards/process.md
@docs/01-standards/writing.md
@docs/01-standards/nextjs.md
@docs/01-standards/components.md
@docs/01-standards/data.md
@docs/01-standards/testing.md
@docs/01-standards/performance.md
@docs/01-standards/accessibility.md
@docs/01-standards/seo.md
@docs/01-standards/git.md
@docs/02-prd/01-brief.md
@docs/02-prd/02-observations.md
@docs/02-prd/03-solution.md
@docs/02-prd/04-design.md
@docs/02-prd/05-architecture.md
@docs/02-prd/06-plan.md
@docs/prd/01-brief.md
@docs/prd/02-observations.md
@docs/prd/03-solution.md
@docs/prd/04-design.md
@docs/prd/05-architecture.md
@docs/prd/06-plan.md

Standards (process, writing, nextjs, components, data, testing, performance, accessibility, seo, git) are supplied by the vendored skills under `.claude/skills/` and `.agents/skills/` and load automatically via skill discovery — no explicit import needed here.
17 changes: 8 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ The v5 redesign of [tko.dev](https://tko.dev/): Tony Ko's **futuristic personal

## Tech stack

Next.js App Router on Tailwind v4, with shadcn/Radix primitives, CVA variants, Framer Motion choreography, and Vitest; the authoritative stack table (versions included) is [docs/02-prd/05-architecture.md §Stack](docs/02-prd/05-architecture.md).
Next.js App Router on Tailwind v4, with shadcn/Radix primitives, CVA variants, Framer Motion choreography, and Vitest; the authoritative stack table (versions included) is [docs/prd/05-architecture.md §Stack](docs/prd/05-architecture.md).

## Getting started

Expand All @@ -30,17 +30,16 @@ pnpm test # vitest

## Docs

Docs drive the implementation, read in numbered order: the rules ([docs/01-standards/](docs/01-standards/)) split by topic, then the PRD ([docs/02-prd/](docs/02-prd/)) as a numbered pipeline ending in the plan (the live milestone list):
Rules by topic (process, writing, nextjs, components, data, testing, performance, accessibility, seo, git) are vendored as skills under `.claude/skills/` and `.agents/skills/`, symlinked from the shared [harness-skills](https://github.com/tkodev/harness-skills) library and loaded automatically via skill discovery. The PRD ([docs/prd/](docs/prd/)) is a numbered pipeline ending in the plan (the live milestone list):

| Doc | What it owns |
| --- | --- |
| [docs/01-standards/](docs/01-standards/) | Rules by topic: [process](docs/01-standards/process.md), [writing](docs/01-standards/writing.md), [nextjs](docs/01-standards/nextjs.md), [components](docs/01-standards/components.md), [data](docs/01-standards/data.md), [testing](docs/01-standards/testing.md), [performance](docs/01-standards/performance.md), [accessibility](docs/01-standards/accessibility.md), [seo](docs/01-standards/seo.md), [git](docs/01-standards/git.md) |
| [docs/02-prd/01-brief.md](docs/02-prd/01-brief.md) | The distilled intent: what the site is, who it's for, aesthetic, references |
| [docs/02-prd/02-observations.md](docs/02-prd/02-observations.md) | Research, risks, and the direction taken on each |
| [docs/02-prd/03-solution.md](docs/02-prd/03-solution.md) | The settled design: concept, surfaces, motion system |
| [docs/02-prd/04-design.md](docs/02-prd/04-design.md) | Design tokens (typography, color, radius, gap, fonts) |
| [docs/02-prd/05-architecture.md](docs/02-prd/05-architecture.md) | Stack, information architecture, repo structure, data layer, theming |
| [docs/02-prd/06-plan.md](docs/02-prd/06-plan.md) | The plan: the live milestone list (dependencies, status, scope) |
| [docs/prd/01-brief.md](docs/prd/01-brief.md) | The distilled intent: what the site is, who it's for, aesthetic, references |
| [docs/prd/02-observations.md](docs/prd/02-observations.md) | Research, risks, and the direction taken on each |
| [docs/prd/03-solution.md](docs/prd/03-solution.md) | The settled design: concept, surfaces, motion system |
| [docs/prd/04-design.md](docs/prd/04-design.md) | Design tokens (typography, color, radius, gap, fonts) |
| [docs/prd/05-architecture.md](docs/prd/05-architecture.md) | Stack, information architecture, repo structure, data layer, theming |
| [docs/prd/06-plan.md](docs/prd/06-plan.md) | The plan: the live milestone list (dependencies, status, scope) |

## Other

Expand Down
9 changes: 0 additions & 9 deletions docs/01-standards/accessibility.md

This file was deleted.

81 changes: 0 additions & 81 deletions docs/01-standards/components.md

This file was deleted.

10 changes: 0 additions & 10 deletions docs/01-standards/data.md

This file was deleted.

42 changes: 0 additions & 42 deletions docs/01-standards/git.md

This file was deleted.

44 changes: 0 additions & 44 deletions docs/01-standards/nextjs.md

This file was deleted.

10 changes: 0 additions & 10 deletions docs/01-standards/performance.md

This file was deleted.

Loading
Loading