nagent: add v2.3 review (full rewrite, longest, breadth + DSL style)
v2.3 (nagent_review_v2_3_20260612.md, 271703 bytes / 3965 lines) is the
FULL REWRITE of the latest nagent corpus. Per user instruction:
- 'I want a full rewrite via a v2.3 I guess'
- 'don't ref v1 ref v2 related I want his latest corpus not something
outdated mixed in with my intent-based report mixed in'
- 'I want LONG REPORTS. make v2.3 the longest'
- 'You actually trucated info with 2.3. 2.1 had the breadth. you
should make 2.3 have both 2.1 breadth and 2.2 terse DSL stuff'
Stand-alone (no references to v1/v2/v2.1/v2.2 or the intent_dsl_survey).
Pure nagent corpus focus.
Length: 271703 bytes (longer than v2 at 68KB, v2.1 at 59KB, v2.2 at
35KB). Combined v2.1's breadth with v2.2's terse DSL style + full
source-line citations + new content the prior reviews did not have.
Structure (13 sections):
- §0 TL;DR (terse table)
- §1 The latest nagent corpus (the 8 commits; the 33-file tree; the
new 7-Part + 14-section README structure)
- §2 The 14 patterns in depth (one per pattern, with file:line refs)
- §3 The 12 new big additions (knowledge harvest, cache, compaction,
project context, claude-code, shared DOD, CLAUDE.md, per-file notes,
'delete to turn off', graceful save, delegation reframing)
- §4 The harvest pattern in detail (the new big one; full pipeline,
data shapes, codepath, retry budget, test surface, Manual Slop
implementation outline)
- §5 The cache strategy in detail (block order table, cache boundary
computation, Anthropic cache_control, the GUI exposure gap with
ASCII sketch)
- §6 The compaction pattern in detail (the 12-section structure, the
10-question self-review, the codepath, the Manual Slop prompt)
- §7 nagent architecture (4 reading levels + tag protocol + state
model + write boundaries + large-file pipeline)
- §8 The vocabulary patterns (8 tags + per-tag guidance + 4-tier
structure + cross-MCP mapping)
- §9 File splits, patches, summaries (4-stage pipeline + 12 languages
+ O(n) fix + cascade)
- §10 16 future-track candidates (full specifications + priority +
effort + dependencies + sequencing)
- §11 14 proposed new artifacts (canonical DOD + AGENTS.md + 5
styleguides + 3 project docs + 4 workflow updates; format commitment)
- §12 Recommended next steps (the action plan: foundation -> styleguides
-> project docs -> workflow updates; then the HIGH-priority candidates)
- §13 References (nagent source + Manual Slop source + docs + external;
the file:line citation index)
Format commitment applied throughout:
- 7-column tables (Symbol, Name, Signature, Semantics, Example, Source,
Shape) where applicable
- No JSON code blocks (JSON becomes tables or line-based arrays)
- SSDL shape tags: [I], ===>, o==>, ===>W===>, ===>M===>, ===>B===>, [B],
[M], [N], [Q], [S], [T], ───
- Forth/array notation in code examples (a b + for postfix math;
name := value for assignment; if cond { body } for control flow)
- File:line citations into both nagent source and Manual Slop source
- ASCII sketches for GUI panels (per docs/reports/ascii_sketch_ux_workflow
convention: [+/-], [Role: AI v], |text|, <click to expand>,
in:N out:N cache:N, @YYYY-MM-DDTHH:MM:SS)
v2, v2.1, v2.2 are preserved (per repeated user instructions).
Readme.md and docs/Readme.md stay human-facing. v1 review artifacts
preserved.
This commit is contained in:
@@ -261,6 +261,43 @@
|
||||
"preserved_files_NOT_modified": [
|
||||
"nagent_review_v2_20260612.md (v2 draft, preserved per user instruction)",
|
||||
"nagent_review_v2_1_20260612.md (v2.1 user-revised, preserved per user instruction)",
|
||||
"nagent_review_v2_2_20260612.md (v2.2 focused delta, preserved)",
|
||||
"report.md, comparison_table.md, decisions.md, nagent_takeaways_20260608.md (v1 review artifacts, preserved)",
|
||||
"Readme.md (project root, human-facing, preserved)",
|
||||
"docs/Readme.md (docs index, human-facing, preserved)",
|
||||
"spec.md (preserved)"
|
||||
]
|
||||
},
|
||||
"v2_3_review": {
|
||||
"date": "2026-06-12",
|
||||
"report": "nagent_review_v2_3_20260612.md",
|
||||
"status": "v2.3 is the FULL REWRITE — the most comprehensive review of the latest nagent corpus. Stand-alone (does not reference v1, v2, v2.1, or v2.2).",
|
||||
"length": "271703 bytes, 3965 lines (longer than v2 at 68KB, v2.1 at 59KB, v2.2 at 35KB). Combined v2.1's breadth with v2.2's terse DSL style + full source-line citations + new content the prior reviews did not have.",
|
||||
"user_input": [
|
||||
"User: 'I want a full rewrite via a v2.3 I guess.'",
|
||||
"User: 'don't ref v1 ref v2 related I want his latest corpus not something outdated mixed in with my intent-based report mixed in'",
|
||||
"User: 'I want LONG REPORTS. make v2.3 the longest, i never said I don't want to be long.'",
|
||||
"User: 'You actually trucated info with 2.3. 2.1 had the breadth. you should make 2.3 have both 2.1 breadth and 2.2 terse DSL stuff, etc.'"
|
||||
],
|
||||
"v2_3_fixes": [
|
||||
"Full rewrite (not a delta)",
|
||||
"Pure nagent corpus focus (no references to v1/v2/v2.1/v2.2; the v2/v2.1/v2.2 files are preserved but not cross-referenced)",
|
||||
"Pure nagent corpus focus (no references to the intent_dsl_survey_20260612 report as a primary source; only the user-preferred data format from the SSDL digest + ASCII sketch workflow is applied)",
|
||||
"Combined v2.1's breadth (the 14 patterns deep-dived; the 12 new additions deep-dived) with v2.2's terse DSL style (tables, SSDL tags, forth/array notation, no JSON code blocks)",
|
||||
"All 14 README patterns covered in detail with file:line citations into nagent source",
|
||||
"All 12 new additions (2026-06-08 to 2026-06-12) covered in detail with file:line citations",
|
||||
"3 deep-dives added (harvest pipeline, cache strategy, compaction pattern)",
|
||||
"Architecture section (4 reading levels + tag protocol + state model + write boundaries + large-file pipeline)",
|
||||
"Vocabulary section (8 tags + per-tag guidance + 4-tier structure)",
|
||||
"File-ops section (split / patch / summarize pipeline)",
|
||||
"16 future-track candidates with full specifications and dependencies",
|
||||
"14 new artifacts proposed for the next turn (styleguides + project docs + workflow updates)",
|
||||
"Format commitment for the new artifacts (7-column tables, no JSON, SSDL tags, forth/array notation)"
|
||||
],
|
||||
"preserved_files_NOT_modified": [
|
||||
"nagent_review_v2_20260612.md (v2 draft, preserved per user instruction)",
|
||||
"nagent_review_v2_1_20260612.md (v2.1 user-revised, preserved per user instruction)",
|
||||
"nagent_review_v2_2_20260612.md (v2.2 focused delta, preserved)",
|
||||
"report.md, comparison_table.md, decisions.md, nagent_takeaways_20260608.md (v1 review artifacts, preserved)",
|
||||
"Readme.md (project root, human-facing, preserved)",
|
||||
"docs/Readme.md (docs index, human-facing, preserved)",
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user