docs: RFCs for interactive DX, shell integration & JS/monorepo templates

[gustavobertoi]

Summary

Proposes the M10 "Interactive-DX" lane as two RFC specs + two ADRs. Design-stage only — no code changes.

The usage guide (docs/guide/) is already on main; this PR adds the forward-looking design docs it points to.

New specs

• docs/specs/30-interactive-dx-and-shell.md — active-context model (persisted default + per-shell override), use/context commands, the shell-init eval hook (zsh/fish plugin, completions, prompt segment — the "execute, don't print" fix), a project TUI, an env/secrets TUI (local env.raw and secret://, project-scoped), a console context header, and ASCII-logo branding.
• docs/specs/31-js-monorepo-templates-and-run.md — a JS/TS + monorepo template library (Express, NestJS, Next.js, React+Vite, Bun, Turborepo) with dev-mode hot reload, and a devstack-native task-graph runner (tasks: + devstack run).

New ADRs (docs/DECISIONS.md)

• D18 — active context & shell integration (persisted-default location, opt-in eval hook, AST YAML round-trip, logo via cobra help hook — fang v2.0.1 has no logo option).
• D19 — task graph as a non-container kind, reusing the internal/hooks executor; no flock, no infra state.

Pointers

• FEATURES.md rows 22–23, a proposed M10 lane in ROADMAP.md, and the guide's whats-next.md now link to the new specs.

Design decisions (locked with the requester)

• Switching = persisted default + per-shell override via the shell eval hook.
• Workspace-scoped env = project-scoped only (no workspace.yaml schema change).
• Monorepo = templates and task-runner together.
• Context surfaced three ways: command header, shell-prompt segment, devstack context.
• App templates ship hot reload (source bind-mount + WSL2 polling).

Notes

• Grounded in the existing substrate: internal/prompt, the dashboard Bubble Tea model, buildManager, internal/hooks, the template engine, node.vite. No invented APIs.
• Four open questions are flagged inline for the drafting stage: [Q-YAML-ROUNDTRIP], [Q-WSL-WATCH], [Q-TURBO-DEFAULT], [Q-CTX-SCOPE].

🤖 Generated with Claude Code