Agents and Claude

[rinatkhaziev]

Description

This pull request adds comprehensive documentation for contributors and future maintainers of the CLI codebase. The most important changes are the addition of a detailed agent guide covering architecture, command anatomy, authentication, API, dev-environment, and migration notes, as well as a pointer file for quick reference.

Documentation improvements:

• Added a new AGENTS.md file containing an in-depth guide for agents, including repo structure, CLI architecture, authentication flow, API/GraphQL layer, dev-environment subsystem, command validation, data paths, release process, common pitfalls, and migration guidance from the current CLI parser.
• Added a CLAUDE.md file that directs users to AGENTS.md for guidance and migration notes.

Pull request checklist

• Update SETUP.md with any new environmental variables.
• Update the documentation.
• Manually test the relevant changes.
• Follow the pull request checklist
• Add/update automated tests as needed.

New release checklist

• Automated tests pass.
• The Preparing for release checklist is completed.

Steps to Test

Outline the steps to test and verify the PR here.

Example:

1. Check out PR.
2. Run npm run build
3. Run ./dist/bin/vip-cookies.js nom
4. Verify cookies are delicious.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[luiztiago]

Formatting is failing, other than that 👍