Private
Public Access
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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user