Skip to content

docs(claude-code): don't present /aidlc slash commands as shell commands#349

Closed
apackeer wants to merge 1 commit into
v2_backupfrom
docs/slash-command-fences
Closed

docs(claude-code): don't present /aidlc slash commands as shell commands#349
apackeer wants to merge 1 commit into
v2_backupfrom
docs/slash-command-fences

Conversation

@apackeer

Copy link
Copy Markdown

Summary

Follow-up to #348. The Quick Start docs presented /aidlc slash commands as shell commands — e.g. cd your-project && /aidlc --doctor in a bash fence — which fails in a terminal: /aidlc only works inside a Claude Code session.

Every affected block is now split into the shell part (install, cd, launch claude) and the in-session part (/aidlc ...):

  • README.md — Quick Start step 2
  • docs/guide/01-getting-started.md — Quick Reference
  • docs/guide/workshop-mode.md — facilitator setup, "Run the Bolt locally", and the walking-skeleton worked example

Swept the rest of the docs (including the shipped dist/ tree) for the same pattern — no other occurrences.

Docs-only; no version bump per the changelog policy.

The Quick Start told readers to run `cd your-project && /aidlc --doctor`
in their shell — /aidlc is a Claude Code slash command and only works
inside a session. Split every affected block into the shell part
(install, cd, launch `claude`) and the in-session part (/aidlc ...),
covering README Quick Start, getting-started Quick Reference, and three
spots in workshop-mode.

@raj-jain-aws raj-jain-aws left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@apackeer

apackeer commented Jul 3, 2026

Copy link
Copy Markdown
Author

Closing as obsolete: this targeted the retired v2_backup branch and edited the old claude-code/ layout, which no longer exists in v2 (core/ + harness/ + dist/). The fix itself has since landed independently: current v2 docs already present /aidlc commands in a plain fence after "Then, inside the Claude Code session:" (README.md, Getting Started), so slash commands are no longer shown as shell commands.

@apackeer apackeer closed this Jul 3, 2026
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.

2 participants