Skip to content

Add cognitive on-ramp and project context - #3

Merged
raelovejoy merged 4 commits into
mainfrom
docs/cognitive-onramps-2026-09-21
Sep 21, 2026
Merged

raelovejoy merged 4 commits into
mainfrom
docs/cognitive-onramps-2026-09-21

Conversation

@raelovejoy

@raelovejoy raelovejoy commented Sep 21, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • add a concise, tailored START-HERE.md cognitive on-ramp
  • add a structured PROJECT-CONTEXT.md for contributors, maintainers, assistants, and tools
  • map canonical sources instead of copying their substance
  • separate current reality from ambition, speculation, prototype evidence, and canon
  • identify project boundaries, repository structure, working rules, and typed ecosystem connections
  • link the short on-ramp to the comprehensive context layer

Why

The project can remain deep without requiring a new or returning person—or an assistant—to reconstruct its purpose and authority model from scattered files. One shared Markdown contract avoids maintaining separate human and AI summaries that could drift apart.

Documentation layers

  1. START-HERE.md: smallest useful mental model.
  2. PROJECT-CONTEXT.md: comprehensive working briefing and source-of-truth map.
  3. Canonical project documents: authoritative detail.
  4. Ecosystem map and Wiki: cross-project navigation and relationships.

Maintenance boundary

Review these summaries only when a change materially affects purpose, present status, active frontier, top-level structure, routing, evidence, privacy, authority, or canon. Automation may propose draft changes but must not publish semantic rewrites directly to the default branch.

Existing draft overlap

README.md is also touched by open draft PR #2; review merge order and preserve both changes.

Review focus

  1. Is “current reality” strictly accurate?
  2. Does the source map point to the actual canonical documents?
  3. Are project relationships directional and non-authoritative?
  4. Does anything expose private material or overstate evidence/status?

@raelovejoy raelovejoy changed the title Add a cognitive on-ramp Add cognitive on-ramp and project context Sep 21, 2026
@raelovejoy
raelovejoy marked this pull request as ready for review September 21, 2026 07:30
@raelovejoy
raelovejoy merged commit 12dcd35 into main Sep 21, 2026
@raelovejoy
raelovejoy deleted the docs/cognitive-onramps-2026-09-21 branch September 21, 2026 07:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant