derek.holloway
7502bf64a4
1.5 KiB
AI Agent Guidelines — rocprofiler-compute
README
README.md is the project's user-facing overview.
Contributing
CONTRIBUTING.md is the project's contributor guide.
Python Code Style
Read and follow .ai/rules/python-style.md before
generating or modifying any Python code. These rules cover function design, naming,
nesting, and code organization.
Ruff and Tooling
All code in src/ must pass Ruff checks. Read .ai/rules/ruff-tooling.md
for enforced rules including type annotations, f-strings, and pathlib usage.
Git Workflows
Prefer the gh CLI for all GitHub interactions (pull requests, issues,
reviews, and authenticated git operations) over any MCP server or tool that
relies on classic PATs (ghp_*), tokens in remote URLs, or pasted credentials.
If gh is not authenticated, ask the user to run gh auth login rather than
supplying a token yourself.
When asked to commit changes, follow .ai/rules/commit-workflow.md
for staging, commit message conventions, pre-commit hook handling, and branch safety.
When asked to create a pull request, follow .ai/rules/pr-workflow.md
for PR template inference, JIRA handling, formatting, and repo identification.
Skills
Reusable agent workflows live under .ai/skills/ with
tool-specific shims in .claude/commands/, .github/prompts/, and
.cursor/commands/.