Skip to content

docs: reconcile design.md + README with the landed crate layout - #63

Merged
zzylol merged 1 commit into
mainfrom
docs/reconcile-design-readme
Jul 2, 2026
Merged

docs: reconcile design.md + README with the landed crate layout#63
zzylol merged 1 commit into
mainfrom
docs/reconcile-design-readme

Conversation

@zzylol

@zzylol zzylol commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Follow-up to the crate reorg (#57): make docs/design.md and README.md accurately distinguish landed from planned.

docs/design.md

  • Status banner up top: this is the target design; §5.1 is what exists.
  • §5 split into "5.1 Landed layout" (crate DAG + real crates/ tree + the parser-quarantine rationale) and "5.2 Target layout (planned)".
  • New §6.0 mapping table — the core::<module> names used throughout §6 → the crates that ship them today (asap-ir / asap-sketch / asap-plan / asap-frontend-*), with status.
  • Fixed stale identifiers in the planned-feature snippets (asap-control-coreasap-ir, asap-control-optimizerasap-plan, core::optimizerasap-plan), the P1 principle, the §11 workspace-members example, and the glossary.

README.md

  • Marked the deployment-model / HTTP-service / CLI consumption modes as planned — only the Rust-library mode is available today.

Docs only; no code touched.

🤖 Generated with Claude Code

…follow-up)

Follow-up to the crate reorg (#57): make the design doc and README accurately
distinguish what's landed from what's still planned.

docs/design.md:
- Status banner up top: this is the target design; §5.1 is what exists.
- §5 split into "5.1 Landed layout" (crate DAG + real tree + parser-quarantine
  note) and "5.2 Target layout (planned)".
- New §6.0 mapping table: the `core::<module>` names used throughout §6 → the
  crates that ship them today (asap-ir / asap-sketch / asap-plan / asap-frontend-*).
- Fixed stale identifiers in planned-feature snippets: asap-control-core ->
  asap-ir, asap-control-optimizer -> asap-plan, core::optimizer -> asap-plan,
  and the P1 principle + §11 workspace-members example.
- Glossary "IR by layer" crate names updated.

README.md:
- Marked the deployment-model / HTTP-service / CLI consumption modes as
  planned (only the Rust-library mode is available today).

Docs only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@zzylol
zzylol merged commit becfa93 into main Jul 2, 2026
1 check passed
@zzylol
zzylol deleted the docs/reconcile-design-readme branch July 2, 2026 17:07
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