Skip to content

docs: optimize agent install instructions for copy-paste into agents#497

Closed
andrewwhitecdw wants to merge 1 commit intopeteromallet:mainfrom
andrewwhitecdw:optimize-agent-instructions
Closed

docs: optimize agent install instructions for copy-paste into agents#497
andrewwhitecdw wants to merge 1 commit intopeteromallet:mainfrom
andrewwhitecdw:optimize-agent-instructions

Conversation

@andrewwhitecdw
Copy link

Enhanced agentic install prompt with feedback from Perplexity.AI and GLM-5.

@peteromallet
Copy link
Owner

Thanks for the contribution, @andrewwhitecdw.

I'm going to pass on this one. The existing agent install prompt is deliberately tuned — the tone, the specific directives (like "don't be lazy" and THE LOOP explanation), and the backlog guidance are all intentional. The PR removes that content and replaces it with more generic AI-instruction patterns (e.g., "You are a code quality agent", "Maintain open-source toolchain discipline") that don't match how the tool actually works.

A few specific concerns:

  • The hardcoded desloppify exclude vendor build dist node_modules .git assumes a directory structure that won't apply to most projects
  • Directives like "Show before/after diffs" and "Confirm resolution command when complete" aren't part of desloppify's workflow
  • The CORE LOOP section duplicates the scan/next/fix cycle that already appears in the prompt

I appreciate the effort, but this is one of those areas where the current version is intentionally non-standard. Thanks for thinking about the agent experience though.

@peteromallet
Copy link
Owner

One more thing worth mentioning — a lot of the detailed agent workflow guidance (THE LOOP, backlog usage, resolve commands, etc.) is delivered via desloppify update-skill, which installs a full skill file tailored to each agent (Claude, Cursor, Copilot, Codex, etc.). So the README prompt is intentionally kept lightweight as an entry point — the heavy lifting happens in the skill file once installed.

@peteromallet peteromallet added the release:v0.9.13 Included in v0.9.13 label Mar 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release:v0.9.13 Included in v0.9.13

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants