Skip to content

Update Agents documentation with build instructions - #181

Merged
richardthe3rd merged 1 commit into
mainfrom
claude/update-agents-docs-uaC5w
Dec 20, 2025
Merged

Update Agents documentation with build instructions#181
richardthe3rd merged 1 commit into
mainfrom
claude/update-agents-docs-uaC5w

Conversation

@richardthe3rd

Copy link
Copy Markdown
Owner

Updates documentation and mise configuration to make it easier for AI agents to discover and use mise for building and testing.

Changes:

  • AGENTS.md: Major update with prominent mise instructions, task discovery guide, CI/CD command mappings, and common mistakes section
  • mise.toml: Add 'install' and 'generate' tasks (previously missing)
  • mise.dev.toml: Add 'build:web:prod' task for production builds
  • CLAUDE.md: Reference AGENTS.md as source of truth for commands
  • copilot-instructions.md: Emphasize mise usage with link to AGENTS.md

Key improvements:

  • Make AGENTS.md the single source of truth for commands
  • Add clear "discover tasks first" workflow (./bin/mise tasks ls)
  • Document CI/CD pipeline to mise task mappings
  • Explain two mise environments (base vs developer)
  • Add troubleshooting section
  • Show common mistakes and correct usage patterns

This addresses the issue where agents struggle to discover how to build and test, by making mise discovery more reliable and prominent.

Updates documentation and mise configuration to make it easier for AI
agents to discover and use mise for building and testing.

Changes:
- AGENTS.md: Major update with prominent mise instructions, task
  discovery guide, CI/CD command mappings, and common mistakes section
- mise.toml: Add 'install' and 'generate' tasks (previously missing)
- mise.dev.toml: Add 'build:web:prod' task for production builds
- CLAUDE.md: Reference AGENTS.md as source of truth for commands
- copilot-instructions.md: Emphasize mise usage with link to AGENTS.md

Key improvements:
- Make AGENTS.md the single source of truth for commands
- Add clear "discover tasks first" workflow (./bin/mise tasks ls)
- Document CI/CD pipeline to mise task mappings
- Explain two mise environments (base vs developer)
- Add troubleshooting section
- Show common mistakes and correct usage patterns

This addresses the issue where agents struggle to discover how to build
and test, by making mise discovery more reliable and prominent.
@github-actions

Copy link
Copy Markdown
Contributor

LCOV of commit e2b9585 during Flutter App CI/CD #939

Summary coverage rate:
  lines......: 72.5% (1889 of 2607 lines)
  functions..: no data found
  branches...: no data found

Files changed coverage rate: n/a

@codecov

codecov Bot commented Dec 20, 2025

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@richardthe3rd
richardthe3rd merged commit 4c8c62f into main Dec 20, 2025
10 checks passed
@richardthe3rd
richardthe3rd deleted the claude/update-agents-docs-uaC5w branch December 20, 2025 09:14
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Cloudflare Pages Preview

Your preview deployment is ready!

Preview URL: https://claude-update-agents-docs-ua.staging-cambeerfestival.pages.dev

This preview will be automatically updated when you push new commits to this PR.

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