Skip to content

Document the --instruction-policy auto import behavior #93

Description

@kelos-bot

kanon import --help advertises --instruction-policy auto, but the README only documents codex, claude, merge, and skip.

I reproduced this in a fresh home: the help text says auto is a valid option, but the onboarding docs never explain what it does or when it differs from the other policies.

Implementation-wise, auto is the default and it:

  • uses Codex instructions when only ~/.codex/AGENTS.md exists
  • uses Claude instructions when only ~/.claude/CLAUDE.md exists, or when both files match
  • errors when both files exist and differ, telling the user to rerun with codex, claude, merge, or skip

Suggested fix: add a short auto description to the README import section and keep the help text/README wording aligned.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions