docs(website): overhaul alistigo.com — ADR pages, framework terminology, logo/favicon - #128
Merged
Merged
Conversation
Relocates docs/architecture.md, docs/arch-check.md, and docs/platform/* into packages/architecture/docs/ so architecture documentation lives alongside the code it describes. Updates all cross-references in CLAUDE.md, README.md, PRDs, and epics, and fixes relative links inside the moved files (ADR links, arch-check references) that are now correct now that the docs are co-located with packages/architecture/adrs/. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add packages/architecture/docs/what-is-alistigo.md: single source of truth synthesizing all PRD content (problem, platform, how it works, milestones, principles) - Delete all 13 PRDs from .agents/prds/ — content now lives in what-is-alistigo.md and docs/milestones.md - Trim docs/README.md to a lean index; remove Vision/Principles/Milestone sections now superseded by the canonical doc - Remove the PRD-reference callout from docs/milestones.md - Add @alistigo/architecture as workspace:* dependency to the website; set implicitDependencies in project.json for Nx cache invalidation - Wire website About sidebar → about/what-is-alistigo using default MDX import (import ArchDoc from '@alistigo/architecture/docs/what-is-alistigo.md') to avoid the reserved Content identifier conflict in Astro 5 / MDX Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Delete docs/milestones.md — milestone roadmap no longer maintained - Remove Milestones section from what-is-alistigo.md; simplify "The Platform (P0+)" heading and intro to drop milestone framing - Delete completed/milestone-named epics: alistigo-ai-m2, alistigo-m1-deployment, archived/alistigo-ai-m1 - Rename .agents/epics/alistigo-platform-foundation → platform-foundation to drop the milestone label while keeping active work items - Remove MILESTONE_TAGS from list-features/src/tags.ts and the mandatory milestone-tag check from validate.ts; remove @m1/@platform tag lines from all 10 .feature files - Update tags.md to reflect Group as the only required Feature-level tag - Strip "M1" from JSDoc in schema-version.ts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…gy, logo/favicon - Auto-generate ADR index and individual pages from @alistigo/architecture/adrs - New content collection wired via glob loader - /adrs/ index lists all ADRs with status and date - /adrs/<slug>/ renders each ADR with Starlight layout - src/content/config.ts replaces content.config.mjs (required for StarlightPage) - Normalize YAML frontmatter on 8 ADRs that were missing it - Replace "platform" with "framework" throughout public-facing content - Rename src/content/docs/platform/ → framework/ - Update page titles, descriptions, and body copy - Add Artifact Catalog page at /artifacts/ - Update homepage hero actions and intro copy - Update packages/architecture/docs/what-is-alistigo.md (transcluded on site) - Homepage improvements - Playground link resolves dev (http://thinkpad:5173/) vs prod (/app/) at build time - Architecture link in body alongside playground button - Logo and favicon - data/logo.svg tracked and symlinked into website as favicon and Starlight header logo - public/favicon.svg → symlink to data/logo.svg - src/assets/logo.svg → symlink to data/logo.svg Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
pnpm's --silent flag suppresses stdout for informational commands in recent versions, causing pnpm store path --silent to emit nothing. The empty output made actions/cache@v4 fail with "Input required and not supplied: path". Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
pnpm@12 ships a JS placeholder that is replaced by a native Rust binary during npm postinstall. When installed via npm:pnpm in mise on the runner, the postinstall doesn't produce a working binary, causing Node.js 24 to throw SyntaxError when pnpm is invoked. Use pnpm/action-setup@v4 (reads packageManager:"pnpm@10.7.0" from package.json) after mise-action in all three jobs to ensure a proper pnpm binary is in PATH before any pnpm calls. Also pin npm:pnpm = "10" in .mise.toml to match package.json and prevent local dev from accidentally pulling pnpm@12+. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
npm:pnpm@10.34.5 is blocked by mise's supply-chain security check (aube) because an earlier version had provenance evidence but this one does not. Switch to mise's native pnpm backend (downloads from GitHub releases, not npm) and pin to 10.7.0 to match packageManager in package.json. Remove the now-unnecessary disable_tools setting that was there to prevent the native backend from conflicting with npm:pnpm. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Contributor
Fallow audit reportFound 3 findings. Details
Generated by fallow. |
Contributor
Fallow audit report0 inline findings selected for GitHub review. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/adrs/index and individual/adrs/<slug>/pages built from@alistigo/architecture/adrsvia Astro content collections; no more manualadrs.md; YAML frontmatter normalized across all 30 ADRsplatform/renamed toframework/, all occurrences of "platform" replaced with "framework" in public-facing content; new Artifact Catalog page at/artifacts/; homepage restructured to explain the two-part nature (framework + catalog)data/logo.svgtracked and symlinked into the website as both the Starlight header logo and the browser favicon; dev playground link resolves tohttp://<hostname>:5173/, prod to/app/Test plan
pnpm buildsucceeds with no errors/framework/overview/renders (not/platform/overview/)/artifacts/renders the artifact catalog page/adrs/lists all 30 ADRs with links/adrs/0001-ui-library/etc. render🤖 Generated with Claude Code