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

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
conductor/tracks/intent_dsl_survey_20260612/plan.md
+43 -43
View File
@@ -2,7 +2,7 @@
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Produce the report at `docs/ideation/2026-06-12-intent-based-scripting-languages.md` (7 sections, ~3500-5000 lines) surveying intent-based scripting languages and proposing a 4-tier vocab for a Meta-Tooling-facing intent DSL. Research-only — no `src/` code, no tests, no `pyproject.toml` changes.
**Goal:** Produce the report at `conductor/tracks/intent_dsl_survey_20260612/report.md` (7 sections, ~3500-5000 lines) surveying intent-based scripting languages and proposing a 4-tier vocab for a Meta-Tooling-facing intent DSL. Research-only — no `src/` code, no tests, no `pyproject.toml` changes.
**Architecture:** The track produces 1 markdown file in `docs/ideation/`. The 7 sections are written sequentially across 3 self-directed phases (1-3) plus 1 user-approval phase (4). Each phase ends with a checkpoint commit. The user sees only the final report and either approves (commit + register in `tracks.md`) or iterates.
@@ -20,7 +20,7 @@ This track creates/modifies the following files:
| File | Action | Purpose |
|---|---|---|
| `docs/ideation/2026-06-12-intent-based-scripting-languages.md` | **Create** | The report. ~3500-5000 lines, 7 sections, 1 appendix. |
| `conductor/tracks/intent_dsl_survey_20260612/report.md` | **Create** | The report. ~3500-5000 lines, 7 sections, 1 appendix. |
| `conductor/tracks/intent_dsl_survey_20260612/state.toml` | **Create** | State file per `conductor/workflow.md` template. |
| `conductor/tracks/intent_dsl_survey_20260612/metadata.json` | **Create** | Track metadata per spec §1. |
| `conductor/tracks.md` | **Modify** | Register track as completed after phase 4. |
@@ -160,7 +160,7 @@ tracks_md_registered = false
"type": "research-only",
"domain": "Meta-Tooling",
"blocked_by": [],
"deliverable": "docs/ideation/2026-06-12-intent-based-scripting-languages.md",
"deliverable": "conductor/tracks/intent_dsl_survey_20260612/report.md",
"consumed_by": [
"nagent v2.2 (Future-Track Candidate #4: Intent-based DSL)",
"intent_dsl_for_meta_tooling_20260608_PLACEHOLDER (per mcp_architecture_refactor_20260606/spec.md §12.1)",
@@ -185,7 +185,7 @@ git commit -m "conductor(track): Add intent_dsl_survey_20260612 state + metadata
### Task 3: Write the 7-section outline as a stub
**Files:**
- Create: `docs/ideation/2026-06-12-intent-based-scripting-languages.md`
- Create: `conductor/tracks/intent_dsl_survey_20260612/report.md`
- [ ] **Step 1: Create the file with the header + 7-section outline (1 paragraph per section)**
@@ -276,16 +276,16 @@ Use the following structure (one paragraph per section; the actual content gets
Run:
```bash
wc -l docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -c "^## " docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -c "^### " docs/ideation/2026-06-12-intent-based-scripting-languages.md
wc -l conductor/tracks/intent_dsl_survey_20260612/report.md
grep -c "^## " conductor/tracks/intent_dsl_survey_20260612/report.md
grep -c "^### " conductor/tracks/intent_dsl_survey_20260612/report.md
```
Expected: ~70 lines, 7 `## ` headings (sections 1-7 + Appendix), ≥10 `### ` headings (clusters + tiers + claims).
- [ ] **Step 3: Phase 1 checkpoint commit**
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Add intent_dsl_survey_20260612 outline stub"
git notes add -m "intent_dsl_survey_20260612 Phase 1 checkpoint (outline)
@@ -319,7 +319,7 @@ git commit -m "conductor(track): Mark intent_dsl_survey_20260612 phase 1 complet
### Task 4: Write section 1 (the philosophy)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 1
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 1
- [ ] **Step 1: Replace the section 1 stub with the 4 anchor claims**
@@ -345,7 +345,7 @@ Continue to next task. Sections 1-3 commit together at end of phase 2.
### Task 5: Write section 2 cluster 0 (O'Donnell)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 0
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 0
- [ ] **Step 1: Replace the cluster 0 stub**
@@ -356,7 +356,7 @@ Per spec §3.2 cluster 0, write 2-3 sentences on the design idea, 2-3 sentences
### Task 6: Write section 2 cluster 1 (Concatenative)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 1
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 1
- [ ] **Step 1: Replace the cluster 1 stub with 6 entries**
@@ -370,7 +370,7 @@ For each:
### Task 7: Write section 2 cluster 2 (Array)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 2
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 2
- [ ] **Step 1: Replace the cluster 2 stub with 4 entries**
@@ -384,7 +384,7 @@ For each:
### Task 8: Write section 2 cluster 3 (Intent-Mapping)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 3
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 3
- [ ] **Step 1: Replace the cluster 3 stub with 4 entries**
@@ -398,7 +398,7 @@ For each:
### Task 9: Write section 2 cluster 4 (Meta-Tooling DSLs)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 4
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 4
- [ ] **Step 1: Replace the cluster 4 stub with 4 entries**
@@ -412,7 +412,7 @@ For each:
### Task 10: Write section 2 cluster 5 (SSDL)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 5
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 5
- [ ] **Step 1: Replace the cluster 5 stub with the 6 SSDL primitives + 7 modifiers**
@@ -423,7 +423,7 @@ Include the table from the SSDL digest (6 primitives + 7 modifiers).
### Task 11: Write section 2 cluster 6 (Command Palette)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 6
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 6
- [ ] **Step 1: Replace the cluster 6 stub with the 33 existing commands + the "Everything" mode future work**
@@ -434,7 +434,7 @@ List 5-10 representative commands by category (View, Edit, Project, Layout, Them
### Task 12: Write section 2 cluster 7 (Result)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 2 cluster 7
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 2 cluster 7
- [ ] **Step 1: Replace the cluster 7 stub with the `Result[T]` + `ErrorInfo` pattern**
@@ -445,7 +445,7 @@ Include the 12 ErrorKind values and the `Result[T]` dataclass signature.
### Task 13: Write section 3 (the grammar)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 3
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 3
- [ ] **Step 1: Replace the section 3 stub with the 14-primitive grammar table + ambiguity flags + precedence rules**
@@ -466,15 +466,15 @@ Per spec §3.3:
Run:
```bash
wc -l docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -c "^## " docs/ideation/2026-06-12-intent-based-scripting-languages.md
wc -l conductor/tracks/intent_dsl_survey_20260612/report.md
grep -c "^## " conductor/tracks/intent_dsl_survey_20260612/report.md
```
Expected: ~1500-2500 lines, 8 `## ` headings (sections 1-7 + Appendix).
- [ ] **Step 2: Phase 2 checkpoint commit**
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Write intent_dsl_survey_20260612 sections 1-3
Section 1: the intent-based design philosophy (4 anchor claims)
@@ -509,7 +509,7 @@ Commit the state update.
### Task 15: Write section 4 Tier 1 (math)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 4 Tier 1
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 4 Tier 1
- [ ] **Step 1: Replace the Tier 1 stub with the 10 math verbs**
@@ -529,7 +529,7 @@ Tier 1 SSDL shape tags: most are `[I]` (single instruction) since they're scalar
### Task 16: Write section 4 Tier 2 (data pipeline)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 4 Tier 2
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 4 Tier 2
- [ ] **Step 1: Replace the Tier 2 stub with the 12 data-pipeline verbs**
@@ -550,7 +550,7 @@ Tier 2 SSDL shape tags: `scan` is `[I]`, `filter`/`map` are `===>` (codepath) or
### Task 17: Write section 4 Tier 3 (shell)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 4 Tier 3
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 4 Tier 3
- [ ] **Step 1: Replace the Tier 3 stub with the 10 shell verbs**
@@ -563,7 +563,7 @@ Tier 3 SSDL shape tags: most are `[I]` (single instruction); `wait`/`poll` are `
### Task 18: Write section 4 Tier 4 (AI-fuzzing tolerance)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 4 Tier 4
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 4 Tier 4
- [ ] **Step 1: Replace the Tier 4 stub with the 8 AI-fuzzing-tolerance verbs**
@@ -584,7 +584,7 @@ Tier 4 SSDL shape tags: most are `[I]` (single instruction); `try { ... } recove
### Task 19: Write section 5 (hardware mapping)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 5
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 5
- [ ] **Step 1: Replace the section 5 stub with the 4 anchor claims**
@@ -597,7 +597,7 @@ Per spec §3.5, the 4 anchor claims:
### Task 20: Write section 6 (AI-agent properties)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 6
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 6
- [ ] **Step 1: Replace the section 6 stub with the 10 claims**
@@ -616,7 +616,7 @@ Per spec §3.6, the 10 claims. Each claim is 1-2 paragraphs. Cite the specific p
### Task 21: Write section 7 (open questions)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` section 7
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` section 7
- [ ] **Step 1: Replace the section 7 stub with 8 open questions + the placeholder connection block**
@@ -637,7 +637,7 @@ The 8 questions from spec §3.7:
### Task 22: Write the Appendix (bibliography)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` Appendix
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` Appendix
- [ ] **Step 1: Replace the Appendix stub with the full bibliography**
@@ -673,9 +673,9 @@ For external references (per spec §13.3):
Run:
```bash
wc -l docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -c "^## " docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -c "^### " docs/ideation/2026-06-12-intent-based-scripting-languages.md
wc -l conductor/tracks/intent_dsl_survey_20260612/report.md
grep -c "^## " conductor/tracks/intent_dsl_survey_20260612/report.md
grep -c "^### " conductor/tracks/intent_dsl_survey_20260612/report.md
```
Expected: ~3500-5000 lines, 8 `## ` headings (sections 1-7 + Appendix), ~30-50 `### ` headings (clusters + tiers + claims + sub-sections).
@@ -695,7 +695,7 @@ For each criterion, confirm:
- [ ] **Step 3: Phase 3 checkpoint commit**
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Write intent_dsl_survey_20260612 sections 4-7 + Appendix
Section 4: the 4-tier vocab (~40 verbs across T1 math, T2 data
@@ -748,13 +748,13 @@ Commit the state update.
### Task 24: Self-review per the brainstorming skill
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` (fix any issues found)
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md` (fix any issues found)
- [ ] **Step 1: Placeholder scan**
Run:
```bash
grep -nE "TBD|TODO|FIXME|XXX|\?\?\?" docs/ideation/2026-06-12-intent-based-scripting-languages.md
grep -nE "TBD|TODO|FIXME|XXX|\?\?\?" conductor/tracks/intent_dsl_survey_20260612/report.md
```
Expected: no matches. If any match, fix them inline.
@@ -796,7 +796,7 @@ Fix any issues inline.
- [ ] **Step 5: Commit any fixes (if any were made)**
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Self-review fixes for intent_dsl_survey_20260612
[Describe the fixes per the self-review pass]"
@@ -816,7 +816,7 @@ Update `state.toml`:
- [ ] **Step 1: Show the report to the user**
Tell the user:
> "Report is ready for your review at `docs/ideation/2026-06-12-intent-based-scripting-languages.md`. ~[N] lines, 7 sections, 4-tier vocab with ~40 verbs, 8-cluster prior art survey, 4 hardware anchor claims, 10 AI-agent properties, 8 open questions for the follow-up interpreter prototype. Please review and let me know if you want any changes."
> "Report is ready for your review at `conductor/tracks/intent_dsl_survey_20260612/report.md`. ~[N] lines, 7 sections, 4-tier vocab with ~40 verbs, 8-cluster prior art survey, 4 hardware anchor claims, 10 AI-agent properties, 8 open questions for the follow-up interpreter prototype. Please review and let me know if you want any changes."
- [ ] **Step 2: Wait for user response**
@@ -827,7 +827,7 @@ The user will either:
### Task 26: Apply user feedback (if any)
**Files:**
- Modify: `docs/ideation/2026-06-12-intent-based-scripting-languages.md`
- Modify: `conductor/tracks/intent_dsl_survey_20260612/report.md`
- [ ] **Step 1: If user requested changes, apply them**
@@ -836,7 +836,7 @@ Make the requested edits to the report.
- [ ] **Step 2: Commit the changes**
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Apply user review feedback to intent_dsl_survey_20260612
[Describe the changes per the user's feedback]"
@@ -844,7 +844,7 @@ git commit -m "docs(ideation): Apply user review feedback to intent_dsl_survey_2
- [ ] **Step 3: Show the updated report to the user for re-review**
> "Applied your feedback in [section/commit reference]. Updated report is at `docs/ideation/2026-06-12-intent-based-scripting-languages.md`. Please confirm the changes are good."
> "Applied your feedback in [section/commit reference]. Updated report is at `conductor/tracks/intent_dsl_survey_20260612/report.md`. Please confirm the changes are good."
Loop back to Task 25 Step 1 if user wants more changes.
@@ -864,7 +864,7 @@ For each criterion, confirm ✓. Update `state.toml` `[verification]` table.
If the report was already committed in Task 26, skip this commit. Otherwise:
```bash
git add docs/ideation/2026-06-12-intent-based-scripting-languages.md
git add conductor/tracks/intent_dsl_survey_20260612/report.md
git commit -m "docs(ideation): Finalize intent_dsl_survey_20260612 report"
```
@@ -931,7 +931,7 @@ Add the new track at the top of the recently-completed section:
```
#### Track: Intent-Based Scripting Languages Survey `[COMPLETE 2026-06-12]`
*Link: [./tracks/intent_dsl_survey_20260612/](./tracks/intent_dsl_survey_20260612/), Spec: [./tracks/intent_dsl_survey_20260612/spec.md](./tracks/intent_dsl_survey_20260612/spec.md), Plan: [./tracks/intent_dsl_survey_20260612/plan.md](./tracks/intent_dsl_survey_20260612/plan.md)*
*Status: COMPLETE 2026-06-12. Report at docs/ideation/2026-06-12-intent-based-scripting-languages.md (~[N] lines, 7 sections, 4-tier vocab with ~40 verbs). Time-sensitive goal met: complete before nagent v2.2. Will be consumed by nagent v2.2 (Candidate #4) and future interpreter prototype (follow-up B).*
*Status: COMPLETE 2026-06-12. Report at conductor/tracks/intent_dsl_survey_20260612/report.md (~[N] lines, 7 sections, 4-tier vocab with ~40 verbs). Time-sensitive goal met: complete before nagent v2.2. Will be consumed by nagent v2.2 (Candidate #4) and future interpreter prototype (follow-up B).*
```
- [ ] **Step 3: Commit the tracks.md update**
@@ -988,7 +988,7 @@ All 21 spec requirements are covered.
**3. Type consistency:** The plan uses consistent terminology throughout:
- Track name: `intent_dsl_survey_20260612` (consistent across all tasks)
- Report path: `docs/ideation/2026-06-12-intent-based-scripting-languages.md` (consistent)
- Report path: `conductor/tracks/intent_dsl_survey_20260612/report.md` (consistent)
- Spec path: `conductor/tracks/intent_dsl_survey_20260612/spec.md` (consistent)
- State path: `conductor/tracks/intent_dsl_survey_20260612/state.toml` (consistent)
- Verbs are consistent with the spec's 4-tier list