add the ghost development log - #259
Merged
Merged
Conversation
…ode paths with spaces
Refined language for clarity and consistency throughout the document. Adjusted phrasing to enhance readability and coherence.
Updated the explanation of the scanning process and the role of the CLI and model. Removed sections discussing guesswork and trust boundaries.
Updated text to clarify the time frame for component library adoption and the limitations of scanners in understanding design intent.
Removed sections discussing the predictability of buckets and the role of Relay in resolving structure.
nahiyankhan
marked this pull request as ready for review
August 13, 2026 04:51
nahiyankhan
added a commit
that referenced
this pull request
Aug 18, 2026
…tion * origin/main: add the ghost development log (#259) # Conflicts: # apps/docs/src/app/page.tsx
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.
Category: improvement
User Impact: Readers can follow ghost's development through a dated public log with RSS support.
Problem: The thesis site had no durable place to explain the project decisions that shaped ghost, and its React/Vite implementation carried more runtime and component machinery than the static site needed.
Solution: Rebuild the site with Astro, add a typed MDX development log and RSS feed, seed five contemporaneous entries that explain the project's evolution, and update CI and Pages deployment for the static build.
Validation:
pnpm check: passedpnpm test: passed, 206 testspnpm --filter ghost-docs typecheck: passed with 0 diagnosticsDEPLOY_BASE=/ghost/ pnpm --filter ghost-docs build: passed, 8 static pages generatedgit diff --check origin/main...HEAD: passedChangeset: not needed because this changes the private docs app and project notes, not the published
@design-intelligence/ghostpackage.ghost Review:
ghost check --base origin/main: not run because this branch predates that command and changes no public package behavior.ghost review --package apps/docs/.ghost --base origin/main: generated an advisory packet with nine material-backed guidance nodes and one applicable visual-expression check. It reports expected coverage gaps for files not named by node materials; no deterministic failure blocks the change.File changes
Docs runtime and configuration
apps/docs/astro.config.mjs,apps/docs/package.json,apps/docs/tsconfig.json,pnpm-lock.yaml: replace the Vite SPA runtime with a static Astro site supporting MDX, React islands, Tailwind, and RSS.apps/docs/index.html,apps/docs/vite.config.ts,apps/docs/src/App.tsx,apps/docs/src/main.tsx,apps/docs/src/vite-env.d.ts: remove the old Vite entrypoints.apps/docs/src/app/page.tsx,apps/docs/src/contexts/ThemeContext.tsx,apps/docs/src/store/preferences-store.ts,apps/docs/src/types/theme.ts,apps/docs/src/types/split-type.d.ts,apps/docs/public/placeholder.svg: remove SPA-only page, state, typing, and placeholder assets.apps/docs/src/components/docs/*: remove the previous React-only docs component layer.Static site and log
apps/docs/src/layouts/Base.astro,apps/docs/src/components/DocSection.astro,apps/docs/src/components/Hero.astro,apps/docs/src/components/Navigation.astro,apps/docs/src/components/SectionWrapper.astro: add the shared Astro page structure.apps/docs/src/pages/index.astro,apps/docs/src/pages/404.astro,apps/docs/src/utils/paths.ts,apps/docs/src/styles/marked-doc.css: render the thesis and fallback pages as static HTML while preserving the site's visual language.apps/docs/src/content.config.ts: define the typed development-log collection.apps/docs/src/pages/log/index.astro,apps/docs/src/pages/log/[id].astro,apps/docs/src/pages/log/rss.xml.ts: add the log index, entry pages, and RSS feed.apps/docs/src/content/log/2026-04-21-detecting-drift.mdx,2026-04-29-the-agent-is-the-reader.mdx,2026-05-19-evidence-is-not-intent.mdx,2026-06-25-brand-is-not-fixed-buckets.mdx,2026-07-18-designing-the-selection-system.mdx: seed contemporaneous entries covering the project's evolution from drift detection to authored guidance and host-agent selection.Project integration
.github/workflows/ci.yml,.github/workflows/deploy-pages.yml,justfile: type-check, build, and deploy the Astro site..gitignore,biome.json,scripts/check-terminology.mjs: account for Astro-generated files and source formats.packages/ghost/test/terminology-public.test.ts,packages/steering-control/test/steering-control.test.ts: keep repository checks reliable with the new log corpus and paths containing spaces.README.md,CLAUDE.md,apps/docs/README.md: describe the thesis site, development log, and authoring workflow.apps/docs/.ghost/anti-goal.generic-ai-product.md,brand.md,composition.md,docs-site.md,pattern.specimen.md,principles.md,visual-system.md: align the site guidance with the Astro implementation and public log.Screenshots/Demos: N/A; this PR preserves the existing thesis presentation while changing its implementation and adding text-first log pages.