Skip to content

docs(ambient): align init/CLI descriptions with keyword detection; tighten preamble directives#236

Merged
dean0x merged 2 commits into
mainfrom
docs/ambient-mode-descriptions
Jun 2, 2026
Merged

docs(ambient): align init/CLI descriptions with keyword detection; tighten preamble directives#236
dean0x merged 2 commits into
mainfrom
docs/ambient-mode-descriptions

Conversation

@dean0x
Copy link
Copy Markdown
Owner

@dean0x dean0x commented Jun 2, 2026

Summary

Ambient mode gained first-word keyword detection in #235 (prompts starting with implement, explore, research, debug, or plan invoke the matching devflow:<keyword> skill). But the init flow, devflow ambient CLI text, plugin description, and README still described plan-only auto-detection — leaving the docs out of step with the two-path hook behavior.

This PR aligns all user-facing copy and tightens the directives the preamble hook injects.

Changes

Descriptions updated to cover both detection paths (keyword + structured plan):

  • src/cli/commands/init.ts — ambient mode prompt note + --ambient flag help
  • src/cli/commands/ambient.ts — command description, usage note, enable-success message, and a stale code comment
  • src/cli/plugins.ts — ambient plugin description → "Keyword + plan auto-detection"
  • README.md — "Ambient intelligence" line now names the keyword start words and structured plans

Injected directives tightened (scripts/hooks/preamble):

  • Symmetric structure across both paths (announce briefly → invoke via Skill tool → pass input)
  • Explicit input pass-through on both paths (the plan path previously never told the model to pass the plan)
  • "Immediately / do not pause to ask whether to proceed" to preserve ambient's zero-friction intent

Notes

  • The preamble hook is copied to ~/.devflow/scripts/ at devflow init time, so the directive change takes effect after a re-init.
  • The plugin README and preamble header comments were already accurate — no change needed there.

Verification

  • npm run build:cli — passes
  • bash -n scripts/hooks/preamble — syntax OK

Dean Sharon added 2 commits June 2, 2026 23:00
…ghten preamble directives Ambient mode gained first-word keyword detection (#235) but the init flow, ambient CLI text, plugin description, and README still described plan-only auto-detection. Update all user-facing copy to cover both detection paths (keyword + structured plan). Also tighten the two directives the preamble hook injects: symmetric structure across both paths, explicit input pass-through, and an immediately/do-not-pause instruction to preserve ambient's zero-friction intent.
@dean0x dean0x merged commit c11cdbf into main Jun 2, 2026
4 checks passed
@dean0x dean0x deleted the docs/ambient-mode-descriptions branch June 2, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant