Marcos Paulo
aae4d42229
Adds the agent-facing workspace and a 20-task plan for migrating the site to Astro. Nothing here implements the refactor; these are briefs, rules and templates that the task agents read. - .agents/ holds context, rules, checklists, skills, specialist agents, component/page/config templates and gate scripts. It is vendor-neutral so MiniMax, Gemini and Codex can all read it; CLAUDE.md just points at AGENTS.md. - .husky/ plus .lintstagedrc.json wire the three gate tiers. gate.sh locks on the shared git-common-dir so parallel worktrees serialise, and guards the assertion count in scripts/verify.mjs against a coverage drop. - plans/astro-refactor/ carries the phase graph, per-task briefs and the model-routing recommendation. These files must be tracked before fanning out: a worktree only checks out tracked files, so an untracked plan is invisible to every agent working in one. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
15 lines
1.0 KiB
Markdown
15 lines
1.0 KiB
Markdown
# Checklist: before you call a page migrated
|
|
|
|
- [ ] URL identical to the old one, **trailing slash included**
|
|
- [ ] Any query params the old page honoured still work (`?author=`, `?skill=`, `?view=`, `?file=`, `?compare=`, `?render=`)
|
|
- [ ] Rendered text content diffs clean against the pre-migration snapshot — or every difference is listed and justified
|
|
- [ ] Same number of JS bytes or fewer; a previously-zero-JS page still ships zero
|
|
- [ ] `<title>`, `<meta name="description">`, and `<meta name="viewport">` preserved
|
|
- [ ] One `<h1>`; heading levels do not skip
|
|
- [ ] Every ARIA attribute from the original survived (`verify.mjs` asserts several)
|
|
- [ ] No external `<script>`, `<link>`, `@import`, or `url()` — `node scripts/audit-ui.mjs` green
|
|
- [ ] Internal links go through `BASE_URL`, not hand-written absolute paths
|
|
- [ ] Screenshots at 560 / 800 / 1100 / 1600 px compared against the old page
|
|
- [ ] `<html lang>` correct and still switching with the language toggle
|
|
- [ ] `npm run verify` green with no assertion deleted
|