Skip to content

docs: Strengthen style guide enforcement in AGENTS.md #91

Description

@randomm

Problem

Developers repeatedly introduce style violations (else statements, destructuring, let instead of const) despite STYLE_GUIDE.md existing. The adversarial review catches these, but it wastes a full review+fix cycle each time.

Solution

Add explicit enforcement section to AGENTS.md:

  • Reference STYLE_GUIDE.md as mandatory (not advisory)
  • List the top violations to avoid (else, destructuring, let, semicolons)
  • Make it clear these are blocking issues, not suggestions

Context

During the current sprint, every single developer task required at least one adversarial fix round for style violations. The PM delegation prompts now include style rules explicitly, but AGENTS.md should reinforce this for all agents.

Acceptance Criteria

  • AGENTS.md references STYLE_GUIDE.md as mandatory compliance
  • Common violations listed explicitly
  • All agents read this before writing code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions