docs(ideation→track): Move report into intent_dsl_survey_20260612 folder

Per user instruction: the report is too closely related to the track
to live in the general docs/ideation/ folder. It's the track's main
deliverable, not a general ideation doc. The existing convention for
track reports is the track folder (e.g., nagent_review_20260608/report.md).

This commit is the phase 2+3 work:
  - Adds the integrated report (417 lines, 8 ## headings, 40 ###)
    to conductor/tracks/intent_dsl_survey_20260612/report.md
  - Adds 5 Tier 2 sub-reports (1319 lines combined) to
    conductor/tracks/intent_dsl_survey_20260612/research/
  - Removes the old docs/ideation/ location (moved, not duplicated)
  - Updates spec.md, plan.md, metadata.json, tracks.md to point at
    the new location

Report structure:
  Section 1: 4 anchor claims (O'Donnell, Onat/Lottes, CoSy, Jofito)
  Section 2: 8 prior-art clusters (with sub-report references)
  Section 3: 14-primitive grammar + ambiguity flags
  Section 4: 4-tier vocab (12+12+10+8 = 42 verbs)
  Section 5: 4 hardware-mapping anchor claims
  Section 6: 10 AI-agent properties
  Section 7: 8 open questions for follow-up B
  Appendix: bibliography (external, project, sub-reports)

The sub-reports contain the deep analysis with citations; the main
report is the ejecutiva summary. Tier 2 sub-agents handled the heavy
research (5 cluster sub-reports in research/); Tier 1 focused on
integration and writing the simpler sections inline.

Time-sensitive: report must complete before nagent v2.2.
This commit is contained in:
ed
2026-06-12 09:28:06 -04:00
parent dfbb03ba06
commit 72e9a63c86
11 changed files with 2721 additions and 162 deletions
@@ -8,7 +8,7 @@
> **Purpose.** This track produces a single research report: a survey of intent-based scripting languages as a design philosophy, plus a proposed vocabulary for a Meta-Tooling-facing intent DSL. The report is the *foundation document* for the user's nagent v2.2 report (its "Future-Track Candidate #4: Intent-based DSL" section) and for the future `intent_dsl_for_meta_tooling_20260608_PLACEHOLDER` placeholder. The track is *research-only*; no interpreter, no integration code.
> **Companion doc.** The actual report is at `docs/ideation/2026-06-12-intent-based-scripting-languages.md`. This `spec.md` is the conductor/track wrapper: the design intent, the relationship to the existing project's tech stack, the 7 report sections and their content, the open questions, the out-of-scope notes, and the verification criteria.
> **Companion doc.** The actual report is at `conductor/tracks/intent_dsl_survey_20260612/report.md`. This `spec.md` is the conductor/track wrapper: the design intent, the relationship to the existing project's tech stack, the 7 report sections and their content, the open questions, the out-of-scope notes, and the verification criteria.
> **Time-sensitivity.** Per the user, the report must be complete *before* nagent v2.2 ships. The track has a single user-approval gate at the end of phase 4; the report can be paused at any phase boundary without losing work.
@@ -222,7 +222,7 @@ At least 6 open questions that the follow-up B track (interpreter prototype) mus
## 4. Per-Section Content Boundaries
The 7 sections are all written into a single markdown file at `docs/ideation/2026-06-12-intent-based-scripting-languages.md`. The file is organized as:
The 7 sections are all written into a single markdown file at `conductor/tracks/intent_dsl_survey_20260612/report.md`. The file is organized as:
- **Header:** track name, date, author, status, "what this is / what this is not" callout
- **Section 1 (~2-3 pages):** the philosophy
@@ -257,7 +257,7 @@ The "testing" of the *report itself* is whether the user finds it useful, well-g
The report is a *standalone artifact*. No migration required:
- The `docs/ideation/2026-06-12-intent-based-scripting-languages.md` file is added to the project tree.
- The `conductor/tracks/intent_dsl_survey_20260612/report.md` file is added to the project tree.
- `conductor/tracks.md` is updated to register the track as completed.
- A git note is attached to the commit per `conductor/workflow.md` §"Task Workflow" step 9.2.
- The placeholder `intent_dsl_for_meta_tooling_20260608_PLACEHOLDER` is *not* modified. The report's section 7 names the connection points so the placeholder track can be filled with the report's vocab when it's specced.
@@ -302,7 +302,7 @@ This track is independent — no blockers. It can be started immediately.
The track is "done" when all of the following are true:
- [ ] The 7 sections of the report are present and non-empty in `docs/ideation/2026-06-12-intent-based-scripting-languages.md`
- [ ] The 7 sections of the report are present and non-empty in `conductor/tracks/intent_dsl_survey_20260612/report.md`
- [ ] Every prior-art claim in section 2 cites a specific source (transcript line, README section, Wikipedia article section, or `file:line` for project files)
- [ ] The user's pseudocode grammar is formalized in section 3 with examples drawn from the `determinate`/`minor`/`matrix-transpose` snippets
- [ ] Every 4-tier verb in section 4 has: signature, one-line semantics, one example, "borrowed from" note, and an SSDL shape tag