docs: mark repository as under construction

Author: gaelic-ghost

README.md

@@ -1,16 +1,26 @@
 # SwiftMonocle
 
-SwiftMonocle is a macOS Swift package scaffold for a focused library project.
+SwiftMonocle is an early macOS-first Swift package for building scoped, syntax-aware coding context.
 
 ## Overview
 
 ### Motivation
 
-This repository starts from a clean Swift Package Manager baseline so the core package shape, local repo maintenance scripts, and repo-local Codex plugin wiring are already in place before product work begins.
+The project is exploring a single canonical `CodeScope` model that can merge editor context, syntax-derived symbols, diagnostics, docs, and agent state into one bounded snapshot for local coding workflows.
 
 ### Current status
 
-The package is intentionally minimal right now. The immediate goal is to keep the repository organized, reproducible, and ready for the first real implementation pass.
+SwiftMonocle is very under construction.
+
+The package is still in its foundation stage, the public API is not stable, and the repository is currently closer to a live design-and-implementation sandbox than a consumable library release.
+
+Recent work has focused on:
+
+- defining the first shared scope snapshot model
+- splitting the package into `Core` and `CodeScope` targets
+- wiring in the first `SwiftSyntax`-backed symbol extraction from live editor buffers
+
+Expect rapid changes, missing features, rough edges, and frequent restructuring while the real product boundary settles.
 
 ## Requirements
 
@@ -31,6 +41,8 @@ Run the tests:
 swift test
 ```
 
+This build is still exploratory. Passing builds and tests only mean the current prototype is internally consistent, not that the package is feature-complete or ready for external adoption.
+
 Run the repo-maintenance validation wrapper:
 
 ```bash
@@ -40,7 +52,9 @@ scripts/repo-maintenance/validate-all.sh
 ## Repository Layout
 
 - `Sources/SwiftMonocle`: package source
-- `Tests/SwiftMonocleTests`: package tests
+- `Sources/SwiftMonocleCore`: shared snapshot, reference, and scope model types
+- `Sources/SwiftMonocleCodeScope`: scope assembly and syntax-driven symbol extraction
+- `Tests`: package test suites
 - `scripts/repo-maintenance`: validation and release helpers installed during bootstrap
 - `.codex/plugins`: repo-local Codex plugin install surface
 
@@ -52,4 +66,4 @@ Because the local Codex app-server install RPC did not return a `plugin/install`
 
 ## Planning
 
-Project planning lives in [`ROADMAP.md`](./ROADMAP.md). Once the product direction is decided, update the roadmap and README together so the repo stays grounded in the same scope.
+Project planning lives in [`ROADMAP.md`](./ROADMAP.md), with additional maintainer design notes in [`docs/maintainers`](./docs/maintainers). Until the first product milestone is fully defined, treat the roadmap and the maintainer docs as the source of truth for what this repository is actually trying to become.