Skip to content

Add migration guides to docs command#1061

Merged
fujiwara merged 1 commit into
pre-v3from
docs-migration-guides
Jul 22, 2026
Merged

Add migration guides to docs command#1061
fujiwara merged 1 commit into
pre-v3from
docs-migration-guides

Conversation

@fujiwara

Copy link
Copy Markdown
Collaborator

What

  • Embed docs/v1-v2.md and docs/v2-v3.md as articles in the docs command, selectable via --article v1-v2 / --article v2-v3 (also listed in --list).
  • Update the embedded agent skill (SKILL.md) to instruct agents to read the migration guide via ecspresso docs --article <from>-<to> before major version upgrades.
  • Update README for the new articles.

Why

Migration guides were only available in the repository. Embedding them in the binary lets users and LLM agents look up breaking changes (e.g. v2 to v3) directly with ecspresso docs, without AWS credentials or network access.

🤖 Generated with Claude Code

Embed docs/v1-v2.md and docs/v2-v3.md as articles in the docs
command, selectable via --article v1-v2 / v2-v3. Update the agent
skill to instruct reading the migration guide before major version
upgrades.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: fujiwara <fujiwara.shunichiro@gmail.com>
@fujiwara fujiwara added the v3 label Jul 22, 2026
@fujiwara
fujiwara merged commit a23551a into pre-v3 Jul 22, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant