ai-agent-guidelines

Guide AI agents through TDD cycles and safe repository edits.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/k2works/grokking-concurrency-exercise --skill ai-agent-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-agent-guidelines
Source: https://github.com/k2works/grokking-concurrency-exercise/tree/main/.claude/skills/ai-agent-guidelines
Command: npx skills add https://github.com/k2works/grokking-concurrency-exercise --skill ai-agent-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a consistent decision framework so an AI agent can autonomously perform development tasks while maintaining quality, minimizing unnecessary confirmations, and ensuring safe, reviewable changes.

Core Features & Use Cases

  • TDD Workflow Enforcement: Guides the Red-Green-Refactor cycle for writing failing tests, implementing minimal fixes, and refactoring safely.
  • Execution Rules & Approvals: Distinguishes actions that can be executed immediately (bug fixes, refactors, test updates) from those requiring confirmation (new files, schema changes, deploy settings).
  • Context & Completion Management: Defines context handling, reporting formats, and a clear completion signal to ensure traceability and handoff readiness.

Quick Start

Use the ai-agent-guidelines to fix a failing unit test by writing a failing test, implementing the minimal code to pass it, refactoring, running all tests, and reporting completion when everything is green.

Frequently Asked Questions about ai-agent-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce a TDD workflow for an autonomous AI agent performing code refactoring?

To enforce TDD for an autonomous AI agent, apply guidelines that mandate a Red-Green-Refactor cycle: write a failing test, implement minimal code to pass, refactor safely, then run all tests and report completion when green.

What development tasks can an autonomous AI agent execute without requiring manual confirmation?

An autonomous AI agent can immediately execute bug fixes, refactoring updates, test additions, and documentation updates without confirmation, but requires approval for new files, schema changes, and deploy settings to ensure safe change scopes.

How does context management work for AI agents handling automated software development tasks?

Context management for AI agents in software development involves defining specific context handling rules, enforcing completion reporting formats, and sending clear completion signals to ensure traceability and handoff readiness after automated edits.

When should I require manual confirmation for AI agent repository edits and dependency changes?

Manual confirmation is required for AI agent repository edits when changes involve new file creation, schema modifications, or deploy settings, while dependency changes and quality assurance workflows need verification before commits.

Does this AI agent guidelines framework support quality assurance and bug fix automation?

Yes, the framework supports quality assurance and bug fix automation by applying a rules-driven decision framework that enforces test-driven workflows, distinguishes safe execution scopes, and requires test verification before commits.

What is the best way to structure completion reporting for autonomous AI development agents?

The best way to structure completion reporting for autonomous AI agents is to enforce standardized reporting formats and clear completion signals, ensuring every automated task maintains traceability and review readiness.