Skip to content

docs(skeep): SKEEP-003 accepted — decisions, memory-architecture design record, M0–M2 roadmap - #1043

Merged
michalharakal merged 1 commit into
developfrom
feature/1004-skeep-003-accepted
Aug 22, 2026
Merged

michalharakal merged 1 commit into
developfrom
feature/1004-skeep-003-accepted

Conversation

@michalharakal

Copy link
Copy Markdown
Contributor

Summary

SKEEP-003 (#932) moves from Draft to Accepted and the memory/storage architecture work becomes a traceable roadmap.

  • docs/modules/skeep/pages/003-unified-tensor-storage.adoc: new Decision (2026-08-22) section — end-state A (storage-first) delivered via end-state B mechanics (new types beside the old ones, TensorData façades, kernel-by-kernel migration, façades removed at the next major); table of the thirteen recorded decisions; package placement (sk.ainet.lang.memory); working rules per slice; Open Questions annotated as resolved; references to the milestone trackers. index.adoc row → Accepted.
  • docs/design/memory/memory-architecture-proposal.md (rev. 2) and docs/design/memory/memory-architecture-milestones-prd.md (M0 · M1 · M2 with sample apps and acceptance numbers) committed as the design record, cross-references updated to repository paths and issues.
  • README "Explore" table + CHANGELOG [Unreleased] link the record.

Roadmap (created with this PR)

Umbrella #932 → milestone trackers #1001 (M0 — Know before you load), #1002 (M1 — Flat decode), #1003 (M2 — 1.58-bit on a 2 GB board), each with sub-issue-linked slices (#1004–#1042). One slice = one feature/<issue>-<slug> branch = one PR; develop stays usable after every merge (additive / façade / opt-in, deprecate-don't-delete, BCV dumps, full test gate before each PR).

Phase P7 (compiled parity) and P8 (façade removal) follow M2 and are not yet filed.

Test plan

Docs-only change. ./gradlew assemble run locally as the smoke gate (result in the first comment); CI build-job must be green.

Closes #1004

🤖 Generated with Claude Code

…ecture design record and M0–M2 roadmap

SKEEP-003 moves from Draft to Accepted: a new Decision section records the
thirteen design decisions (storage-first end-state delivered incrementally via
façades; Storage / TensorView / Tensor naming; decoding get(); (head, tail)
KV windows; Encoding.activation; Phase-2 access-path benchmark; suspend
source placement; axis labels; structured TensorId; activation ids; 2 GB
planner profile; debugger surface; LogicalDType → DType merge), the open
questions are annotated as resolved, and the references point at the roadmap
trackers #1001 (M0), #1002 (M1), #1003 (M2) under umbrella #932.

The full proposal (rev. 2) and the M0/M1/M2 milestone PRD are committed under
docs/design/memory/ with their cross-references updated to repository paths
and issues (the kernel contract sample is a deliverable of #1027; the
infographic reference is dropped). README "Explore" table and CHANGELOG
[Unreleased] link the record.

Closes #1004

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@michalharakal

Copy link
Copy Markdown
Contributor Author

Local smoke gate for this docs-only PR (JDK 25):

./gradlew --no-daemon --stacktrace -Dorg.gradle.caching=true -Dorg.gradle.configuration-cache=true assemble
BUILD SUCCESSFUL in 4m 33s

@github-actions

Copy link
Copy Markdown

📖 Documentation Preview

The documentation has been built successfully for this PR.

Generated Files:

  • Operator documentation: docs/modules/operators/_generated_/
  • JSON schema output: operators.json

Artifacts:

  • Download the documentation-preview-1043 artifact to view the complete documentation locally.

This comment will be updated automatically when the PR is updated.

@michalharakal
michalharakal requested a review from aharakal August 22, 2026 15:08
@michalharakal
michalharakal merged commit 78f0c62 into develop Aug 22, 2026
15 checks passed
@michalharakal
michalharakal deleted the feature/1004-skeep-003-accepted branch August 22, 2026 17:12
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.

[S0.10a] SKEEP-003 → Accepted: record the 13 decisions, commit proposal + PRD, link the roadmap

2 participants