Skip to content

blog: guiding your agents#13

Merged
Pertempto merged 3 commits intomainfrom
blog/agents.md-structure
Mar 16, 2026
Merged

blog: guiding your agents#13
Pertempto merged 3 commits intomainfrom
blog/agents.md-structure

Conversation

@Pertempto
Copy link
Copy Markdown
Contributor

No description provided.

@github-actions
Copy link
Copy Markdown

Code Review: PR #13

Title Check

The PR title "blog: structuring AGENTS.md" follows conventional commit style (type: message format). ✅

Content Review

Strengths:

  • Well-structured blog post with clear sections covering best practices
  • The three-tier system (Always Do, Ask First, Never Do) is a practical framework
  • Good use of external resources (arxiv study, addyosmani.com reference)
  • Includes practical advice about avoiding documentation rot
  • Mentions Agent Skills as an alternative to bloating AGENTS.md

Minor Suggestions:

  • Line 30: The link to addyosmani.com has a long URL fragment. Consider using a URL shortener or cleaner link format for readability.
  • The post could benefit from a brief code example or concrete scenario demonstrating the three-tier system in practice.

Overall: The content is informative and aligns well with the project's apparent focus on effective agent collaboration patterns. No blockers.


Review by opencode


🔗 OpenCode Session

@Pertempto Pertempto changed the title blog: structuring AGENTS.md blog: guiding your agents Mar 16, 2026
@Pertempto Pertempto self-assigned this Mar 16, 2026
@Pertempto Pertempto requested a review from bambam955 March 16, 2026 17:58
@Pertempto Pertempto marked this pull request as ready for review March 16, 2026 18:03
Copy link
Copy Markdown
Contributor

@bambam955 bambam955 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is really good! I find the insight about the relationship between AGENTS.md and agent skills to be really really helpful.

I recently saw a post where someone said (kind of joking but kind of not) that "context engineering" would become the chief job of a software dev soon. I don't know if that's true or not, but this definitely gives me a good starting point for how to manage agents more effectively 💯 💯 💯

@Pertempto Pertempto merged commit 89405a4 into main Mar 16, 2026
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