diff --git a/docs/superpowers/plans/2026-07-09-website-suite.md b/docs/superpowers/plans/2026-07-09-website-suite.md new file mode 100644 index 0000000..3f5f5a0 --- /dev/null +++ b/docs/superpowers/plans/2026-07-09-website-suite.md @@ -0,0 +1,772 @@ +# Website Suite Redesign Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Reposition git-agentic.com as a suite site: a new landing page presenting three projects (git.agentic, src-control, Sentinel), with full product pages per project. + +**Architecture:** Astro static site in `website/` (already deployed). Four routes (`/`, `/git-agentic`, `/src-control`, `/sentinel`) sharing extracted `Header.astro`/`Footer.astro` components and the existing `Base.astro` global styles. No new dependencies, no client JS. + +**Tech Stack:** Astro 6 (`website/package.json`), plain HTML/CSS, existing nginx deploy. + +**Spec:** `docs/superpowers/specs/2026-07-09-website-suite-design.md` — read it before starting. + +## Global Constraints + +- Work in the `.worktrees/website-suite/` worktree on branch `website-suite`; never edit the main checkout. +- All commands below run from `/website/` unless a path is shown. +- Routing facts: `astro.config.mjs` has `trailingSlash: 'never'` and `build.format: 'file'` → internal links are `/git-agentic`, `/src-control`, `/sentinel` (NO trailing slash) and build output is `dist/git-agentic.html` etc. nginx already serves these via `try_files $uri $uri/ $uri.html`. +- Visual language unchanged: dark background, mono body, single orange accent, existing `ok`/`bad`/`comment` terminal coloring. No per-project color themes. No new dependencies. No client-side JS. +- Content accuracy: every product claim must be traceable to that project's README/ARCHITECTURE/docs. Terminal snippets are real (possibly condensed) README/demo output or verbatim README commands with comments — never fabricated transcripts. +- Statuses (exact): git.agentic "v1.0 shipped · v1.1 in progress"; src-control "Phases 1–9 implemented"; Sentinel described by capabilities, **never** phase numbers. +- Repo URLs: `https://github.com/git-agentic/git.agentic`, `https://github.com/git-agentic/src-control`, `https://github.com/git-agentic/pkg-registry` (Sentinel), org `https://github.com/git-agentic`. +- "Test" for this static site = `npm run build` + `grep` assertions against `dist/` output (there is no JS test framework in `website/` and we are not adding one). + +--- + +### Task 1: Shared Header/Footer components + `/git-agentic` page + +Extract the site chrome into components and create the flagship product page by moving the current homepage content, with exactly three changes: Projects section removed, status updated to shipped-v1.0, shared chrome. + +**Files:** +- Create: `website/src/components/Header.astro` +- Create: `website/src/components/Footer.astro` +- Create: `website/src/pages/git-agentic.astro` +- Modify: `website/src/layouts/Base.astro` (two small global-CSS additions) +- Reference (do not modify yet): `website/src/pages/index.astro` + +**Interfaces:** +- Consumes: `Base.astro` props `{ title?: string; description?: string }` (already exist). +- Produces: `
` and `