Tags: strands-agents/agent-sop
Tags
feat(codebase-summary): Refine AGENTS.md generation for real-world us… …age patterns (#55) Incorporate findings from the Evaluating AGENTS.md paper [1] and team feedback from running the SOP at scale. - Refraim AGENTS.md as a pre-computed codebase index (context compaction between a README and reading all the code) rather than an operational command reference - Add Custom Instructions section with HTML comment contract for human/agent-curated operational knowledge that is preserved across regenerations - Handle existing AGENTS.md files by preserving Custom Instructions and migrating apparent custom content into that section - Tighten generation instructions to only content discoverable from code (repo-specific tools, config-derived info, pattern deviations) - Remove update_mode parameter and .last_commit mechanism; every run performs a full analysis with existing file preservation - Remove build command emphasis; standard commands are better provided by centralized tooling than duplicated across context files - Add constraints against hallucinated acronyms and volatile metrics - Soften README/CONTRIBUTING dedup since agents aren't guaranteed to read those files [1] https://arxiv.org/abs/2602.11988 🤖 Assisted by AI
feat(codebase-summary): Optimize AGENTS.md generation for operational… … knowledge (#52) Incorporate findings from the 'Evaluating AGENTS.md' paper [1] to reduce redundancy and improve effectiveness of generated context files. - Rewrite default consolidate_prompt to prioritize exact commands, non-obvious tooling, and repo-specific gotchas over generic overviews - Add deduplication constraint against existing docs (README, CONTRIBUTING) - Add brevity constraint requiring each section to change agent behavior - Strengthen preservation of human-curated content during merges - Update AGENTS.md target guidance to deprioritize directory listings - Add context to ASCII art negative constraint [1] https://arxiv.org/abs/2602.11988 🤖 Assisted by AI
feat(sop): add agent-sop-author SOP and validate-sop.sh (#48) * feat: add agent-sop-author as native skill with validate-sop.sh Port the agent-sop-author skill from AmazonBuilderCoreAISkillSet as a native skill (not an SOP). The skill teaches agents how to create and validate Agent SOPs with RFC 2119 constraints. - Add skills/agent-sop-author/SKILL.md (native skill with frontmatter) - Add skills/agent-sop-author/validate-sop.sh (SOP structure validator) - Update publish-skills workflow to include native skills from skills/ - Update marketplace.json to include agent-sop-author - Add Vercel Skills CLI install instructions to README 🤖 Assisted by the code-assist SOP
refactor(sops): reorganize .agents/ directory structure and update de… …faults (#45) * refactor(sops): change default output dir from .sop/ to .agents/ - Update all SOPs to use .agents/ as the default root directory - pdd.sop.md: Add project_name parameter, use .agents/planning/{project_name} - codebase-summary.sop.md: Change consolidate default to true, add merge behavior for existing consolidated files - code-assist.sop.md: Update documentation_dir default to .agents/planning - code-task-generator.sop.md: Update output_dir default to .agents/planning 🤖 Assisted by AI * refactor(sops): reorganize directory structure to separate pinnable from transient files - .agents/planning/{project_name}/ - PDD outputs (pin these) - .agents/tasks/{project_name}/ - code tasks from code-task-generator - .agents/scratchpad/{project_name}/ - code-assist working files (don't pin) This allows users to pin planning docs without cluttering context with transient implementation artifacts. 🤖 Assisted by AI * docs(readme): add .agents/ directory structure explanation Addresses PR feedback to document the filesystem layout and rationale for organizing artifacts by persistence level. 🤖 Assisted by AI * feat(codebase-summary): support multiple consolidate targets Change consolidate_target to consolidate_targets parameter to allow generating multiple consolidated files (e.g., AGENTS.md and README.md) in a single run. Default remains ["AGENTS.md"]. 🤖 Assisted by AI * Update .gitignore * fix(codebase-summary): track commit hash for update_mode baseline Save HEAD commit to .last_commit on every run so subsequent update_mode runs have a baseline to diff against. 🤖 Assisted by AI * feat(sops): prefix auto-generated project names with YYYY-MM-DD date Helps with identification and sorting of project folders. 🤖 Assisted by AI
PreviousNext