ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

nagent: add v2 and v2.1 review reports

Browse Source 
- v2 (nagent_review_v2_20260612.md, ~68KB): first delta report on the 8 new
  nagent commits between 2026-06-08 and 2026-06-12. Introduces 5 new
  future-track candidates (11-15): knowledge harvest, stable-to-volatile
  context ordering for caching, conversation compaction, project context
  files, save-with-graceful-summary-failure. Notes heavy RAG emphasis as
  the comparison frame for knowledge harvest (later corrected in v2.1).

- v2.1 (nagent_review_v2_1_20260612.md, ~59KB): user-driven revision of v2.
  Five corrections applied:
  1. CLAUDE.md -> AGENTS.md swap (Manual Slop has AGENTS.md, not CLAUDE.md)
  2. Reframed Candidate 11 from 'RAG alternative' to 'third memory
     dimension' (curation + discussion + RAG + knowledge)
  3. Cache TTL GUI controls added (sub-candidate 12b) per user request
  4. RAG integration discipline added (new sub-section 2.10) per user's
     'be conservative' rule
  5. v2 preserved as draft; v2.1 is non-destructive new file

  v2.1 also proposes new agent-facing artifacts (canonical DOD file,
  AGENTS.md update, new ./docs/AGENTS.md) and 8 new styleguides/docs.
  v2.1 source-citations grounded in 18 nagent source files read in full.

- state.toml and metadata.json updated with v2.1 tasks and a v2.1_review
  block; v1 artifacts preserved per original user instruction.

Pending: style preferences (table-based, forth/array-like, not JSON) and
the user's upcoming intent-based-scripting-languages report.
This commit is contained in:
ed
2026-06-12 08:16:08 -04:00
parent 192a3743c7
commit 77141363bc
4 changed files with 1648 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/tracks/nagent_review_20260608/state.toml
+39 -1
View File
@@ -7,7 +7,7 @@ track_id = "nagent_review_20260608"
name = "nagent Review (Mike Acton's data-oriented LLM agent reference)"
status = "active"
current_phase = 0 # 0 = pre-completion; this track produces no code phases
last_updated = "2026-06-08"
last_updated = "2026-06-12"
[user_corrections_log]
# Corrections applied to the first draft based on direct user feedback during review
@@ -39,6 +39,44 @@ t_write_07 = { status = "pending", commit_sha = "", description = "Add entry
t_write_08 = { status = "pending", commit_sha = "", description = "Human review of report.md + nagent_takeaways_20260608.md (final)" }
t_archive = { status = "pending", commit_sha = "", description = "Move track to conductor/tracks/archive/ when follow-up tracks are specced (or sooner if no value remains)" }
# v2 review (2026-06-12): 8 new nagent commits since v1; README restructured; knowledge harvest is the major new pattern
t_v2_review_01 = { status = "completed", commit_sha = "", description = "v2 review: enumerate 8 new nagent commits between 2026-06-08 and 2026-06-12" }
t_v2_review_02 = { status = "completed", commit_sha = "", description = "v2 review: document knowledge harvest (nagent-gc) pattern + per-file notes" }
t_v2_review_03 = { status = "completed", commit_sha = "", description = "v2 review: document stable-to-volatile context ordering for prompt caching" }
t_v2_review_04 = { status = "completed", commit_sha = "", description = "v2 review: document conversation compaction (--compact) vs summarization" }
t_v2_review_05 = { status = "completed", commit_sha = "", description = "v2 review: document project context files, claude-code provider, save-with-graceful-failure" }
t_v2_review_06 = { status = "completed", commit_sha = "", description = "v2 review: map staleness in v1 report.md / comparison_table.md / decisions.md / nagent_takeaways_20260608.md" }
t_v2_review_07 = { status = "completed", commit_sha = "", description = "v2 review: propose 5 new future-track candidates (11-15) with priority and effort" }
t_v2_review_08 = { status = "completed", commit_sha = "", description = "v2 review: write nagent_review_v2_20260612.md (new file; v1 preserved)" }
t_v2_review_pending_01 = { status = "pending", commit_sha = "", description = "User to surface Candidate 11 (Knowledge Harvest) as the primary v2 finding" }
t_v2_review_pending_02 = { status = "pending", commit_sha = "", description = "Tier 2 source-read: verify Candidate 15 (save-with-graceful-summary-failure) is potentially a latent bug" }
t_v2_review_pending_03 = { status = "pending", commit_sha = "", description = "Update v1 decisions.md to add Candidates 11-15 and refresh re-rankings" }
t_v2_review_pending_04 = { status = "pending", commit_sha = "", description = "Update v1 comparison_table.md to add 4 new rows and 4 row updates" }
t_v2_review_pending_05 = { status = "pending", commit_sha = "", description = "Update v1 nagent_takeaways_20260608.md to add 3 new takeaways and refresh 6 existing" }
t_v2_review_pending_06 = { status = "pending", commit_sha = "", description = "Update agent workflow docs (AGENTS.md, conductor/workflow.md, conductor/product-guidelines.md) to incorporate v2 design principles" }
t_v2_review_pending_07 = { status = "pending", commit_sha = "", description = "Tier 2 source-read: verify 8 items in nagent_review_v2_20260612.md §8 before any new candidate is scoped" }
# v2.1 review (2026-06-12, second user iteration): user corrections to v2
# v2 file is PRESERVED as the draft; v2.1 is the user-revised version
t_v2_1_review_01 = { status = "completed", commit_sha = "", description = "v2.1: read full nagent source (bin/nagent, nagent_gc_lib.py, nagent_tags.py, nagent_llm.py, nagent_gc CLI, prompts/*.md, context/data-oriented-design.md, CLAUDE.md) — 18 files in full" }
t_v2_1_review_02 = { status = "completed", commit_sha = "", description = "v2.1: reframe Candidate 11 from 'RAG alternative' to 'third memory dimension' (curation + discussion + RAG + knowledge)" }
t_v2_1_review_03 = { status = "completed", commit_sha = "", description = "v2.1: swap CLAUDE.md → AGENTS.md throughout (Manual Slop has AGENTS.md, not CLAUDE.md)" }
t_v2_1_review_04 = { status = "completed", commit_sha = "", description = "v2.1: add cache TTL GUI controls (sub-candidate 12b) — per the user's explicit ask for 'how long the caches are available for (gemini has a limit for example)'" }
t_v2_1_review_05 = { status = "completed", commit_sha = "", description = "v2.1: add new RAG integration discipline sub-section (§2.10) — 'we should be conservative' about wiring RAG; codify when RAG fits (semantic search across large codebases) and when it does not (curation/discussion/knowledge)" }
t_v2_1_review_06 = { status = "completed", commit_sha = "", description = "v2.1: preserve v2 as the draft (NON-DESTRUCTIVE write to nagent_review_v2_1_20260612.md)" }
t_v2_1_review_07 = { status = "completed", commit_sha = "", description = "v2.1: preserve Readme.md and docs/Readme.md as human-facing; propose new agent-facing files instead (AGENTS.md @import update; new ./docs/AGENTS.md)" }
t_v2_1_review_08 = { status = "completed", commit_sha = "", description = "v2.1: write nagent_review_v2_1_20260612.md (new file, ~59KB) with the reframe, the swap, the new styleguide list, the new docs list, and the workflow doc update plan" }
# v2.1 pending (for the next turn)
t_v2_1_review_pending_01 = { status = "pending", commit_sha = "", description = "User review of v2.1 + confirmation of which new artifacts to create in the next turn" }
t_v2_1_review_pending_02 = { status = "pending", commit_sha = "", description = "Create canonical DOD file at conductor/code_styleguides/data_oriented_design.md (cloned/adapted from nagent's context/data-oriented-design.md)" }
t_v2_1_review_pending_03 = { status = "pending", commit_sha = "", description = "Update AGENTS.md to add @conductor/code_styleguides/data_oriented_design.md import + 'what this is' section" }
t_v2_1_review_pending_04 = { status = "pending", commit_sha = "", description = "Create ./docs/AGENTS.md as agent-facing mirror of docs/Readme.md (which stays human-facing)" }
t_v2_1_review_pending_05 = { status = "pending", commit_sha = "", description = "Write 5 new styleguides (agent_memory_dimensions.md, rag_integration_discipline.md, cache_friendly_context.md, knowledge_artifacts.md, feature_flags.md)" }
t_v2_1_review_pending_06 = { status = "pending", commit_sha = "", description = "Write 3 new docs (guide_knowledge_curation.md, guide_caching_strategy.md, guide_agent_memory_dimensions.md)" }
t_v2_1_review_pending_07 = { status = "pending", commit_sha = "", description = "Update existing workflow docs (conductor/workflow.md, conductor/product-guidelines.md, docs/guide_mma.md, docs/guide_ai_client.md) with v2.1 patterns" }
t_v2_1_review_pending_08 = { status = "pending", commit_sha = "", description = "Verify Candidate 15 (save-with-graceful-summary-failure) by reading src/ai_client.py:run_discussion_compression" }
[user_wants_recorded]
# User explicitly wants these in priority order (see decisions.md for full detail)
want_1_sub_conversation_runner = "EXPLICIT: 'I probably want to add that for just 1:1 discussions where I use a sub-agent manually for specific points'"