Skip to content

docs: GitHub Wiki pages (fallback — wiki repo not yet initialized)#2

Draft
testtest126 wants to merge 1 commit into
mainfrom
docs/wiki-pages
Draft

docs: GitHub Wiki pages (fallback — wiki repo not yet initialized)#2
testtest126 wants to merge 1 commit into
mainfrom
docs/wiki-pages

Conversation

@testtest126

Copy link
Copy Markdown
Owner

What this is

Seven wiki pages documenting LULL as it actually exists in the repo today —
written by reading README.md, CLAUDE.md, docs/concept.md, all of LULLKit's
sources, the app's views, project.yml, and the experiment/spritekit-atmosphere
branch / draft PR #1. No invented lore or unbuilt features are presented as
shipped.

  • Home — one-line hook + table of contents
  • Concept & Design — the horror premise and consent-first philosophy, with
    an explicit "implemented vs. named only" status column on the fear-mechanics
    table
  • The Safety Invariant — the honest version: the forbidden-sensor
    guarantee (Sensor enum has no case for photos/contacts/location) is
    genuinely compiler-enforced; the consent-gates-camera guarantee is correct
    today but rests on GameModel.allowTheEye() being the only call site, not
    on anything the type system would catch if a second call site were added
  • Architecture — LULLKit vs. app target, ConsentLedger and EyeSession
    as Mermaid diagrams, CameraController, GameModel, the view layer
  • Building & Running — the XcodeGen flow and swift test for LULLKit
  • Atmosphere (experiment) — the SpriteKit prototype on PR Experiment: SpriteKit atmosphere layer #1, including
    its own "honest read" that plain SwiftUI/Core Animation likely suffices for
    ambience and SpriteKit earns its keep once the dread needs to react
  • Roadmap / Ideas — clearly marked tentative; only what the README's
    status notes and fear-mechanics table genuinely imply is next

Why this is here instead of the wiki

github.com/testtest126/LULL.wiki.git doesn't exist yet as a clonable repo
(git clone → "repository not found") because no page has ever been created
through the wiki's web UI — GitHub doesn't initialize a wiki's git repo until
that happens once, even with has_wiki enabled on the main repo. This PR
puts the same content under docs/wiki/ so it exists and is reviewable
regardless of that step. Once the first wiki page is created via
github.com/testtest126/LULL/wiki → "Create the first page", these files
can be copied straight into the wiki repo (same filenames = same page slugs).

Scope

Docs only — no app or LULLKit source changed.

🤖 Generated with Claude Code

Seven pages documenting LULL as it actually exists in the repo: concept,
the safety invariant (honest split between compiler-enforced and
convention-enforced guarantees), architecture, build/test instructions,
the SpriteKit atmosphere experiment (PR #1), and a tentative roadmap.

These live in docs/wiki/ as a fallback because github.com/testtest126/LULL.wiki
has never had a first page created through the web UI, so its git repo
doesn't exist yet to clone/push to. Same content is meant to be copied into
the live wiki once that's done.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant