Skip to content

Add usethis-cli-dogfood agent skill#1691

Merged
nathanjmcdougall merged 4 commits intomainfrom
copilot/agent-config-dogfooding-tests
Apr 1, 2026
Merged

Add usethis-cli-dogfood agent skill#1691
nathanjmcdougall merged 4 commits intomainfrom
copilot/agent-config-dogfooding-tests

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 1, 2026

PR #1639 revealed that agents implementing new CLI commands miss edge cases caught by running the command against the real repo. This adds a skill documenting the safe dogfooding workflow.

New skill: usethis-cli-dogfood

Instructs agents to validate new/modified CLI commands against the usethis repo itself:

# 1. Clean worktree
git add . && git commit -m "WIP: pre-dogfood checkpoint"

# 2. Run the command against the real project (uvx avoids venv clashes)
uvx --from . usethis tool <newtool>

# 3. Analyze output for crashes, bad config, unexpected behavior

# 4. Revert side-effects (not appropriate to commit)
git checkout -- . && git clean -fd

# 5. Write failing tests for any discovered issues, then fix
  • .agents/skills/usethis-cli-dogfood/SKILL.md — skill file with procedure, safety considerations
  • .agents/skills/usethis-cli-modify/SKILL.md — updated to reference the new dogfood skill as step 4 in its procedure
  • docs/skills-directory.txt, AGENTS.md — registry entries

Create a new agent skill that instructs agents to safely run new or
modified CLI commands against the usethis repo itself to catch edge
cases. Documents the commit-run-revert workflow to avoid polluting
the worktree.

Resolves #1641

Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/ce6595ee-5690-42c1-8925-a7904e640b57

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
Copilot AI changed the title [WIP] Update agent configuration for dogfooding tests Add usethis-cli-dogfood agent skill Apr 1, 2026
Copilot AI requested a review from nathanjmcdougall April 1, 2026 04:30
@nathanjmcdougall nathanjmcdougall marked this pull request as ready for review April 1, 2026 05:00
Comment thread .agents/skills/usethis-cli-dogfood/SKILL.md Outdated
Avoids clashing with the usethis executable in the project's virtual
environment.

Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/9b7aa282-570b-44ca-b1b5-26e904ec3f33

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
Comment thread AGENTS.md
@nathanjmcdougall nathanjmcdougall merged commit 38e1a50 into main Apr 1, 2026
11 checks passed
@nathanjmcdougall nathanjmcdougall deleted the copilot/agent-config-dogfooding-tests branch April 1, 2026 09:44
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.

Agent config to undertake dogfooding tests when implementing a new command

2 participants