Skip to content

docs: update README with new patterns #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jeremyeder merged 1 commit into from
Jan 5, 2026
Merged

docs: update README with new patterns #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 21 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,8 @@ Pick what you need. Each pattern works independently:
| Pattern | Description | How to Adopt |
| ------- | ----------- | ------------ |
| **Codebase Agent** | AI agent configuration patterns | Copy `.claude/` structure |
| **Self-Review Reflection** | Agent reviews own work before delivery | Reference `docs/patterns/self-review-reflection.md` |
| **GHA Automation** | Issue-to-PR, PR review, auto-merge, stale issues | Reference `docs/patterns/gha-automation-patterns.md` |
| **Architecture** | Layered architecture patterns | Reference `docs/architecture.md` |
| **Security** | Security best practices | Reference `.claude/context/security-standards.md` |
| **Testing** | Test organization patterns | Reference `.claude/context/testing-patterns.md` |
Expand Down Expand Up @@ -76,17 +78,32 @@ The demo repository includes:

## Key Patterns

### Agent Behavior Patterns

How AI agents work during development:

- **[Self-Review Reflection](docs/patterns/self-review-reflection.md)** - Agent reviews own work before presenting to humans
- **[Autonomous Quality Enforcement](docs/patterns/autonomous-quality-enforcement.md)** - Validate code before presenting
- **[Multi-Agent Code Review](docs/patterns/multi-agent-code-review.md)** - Parallel specialized reviews

### GHA Automation Patterns

Proactive CI/CD workflows in [`docs/patterns/gha-automation-patterns.md`](docs/patterns/gha-automation-patterns.md):

- **Issue-to-PR Automation** - Convert issues to draft PRs automatically
- **PR Auto-Review** - AI code review on every PR
- **Dependabot Auto-Merge** - Safe auto-merge for patch updates
- **Stale Issue Management** - Cleanup inactive issues

### Codebase Agent (CBA)

AI agent configuration patterns for:
AI agent configuration patterns in [`.claude/agents/codebase-agent.md`](.claude/agents/codebase-agent.md):

- **Issue-to-PR Automation** - Converting well-defined issues into pull requests
- **Code Reviews** - Providing actionable feedback
- **Proactive Maintenance** - Dependency updates, linting, documentation
- **Memory System** - Modular context files for consistency

See [`.claude/agents/codebase-agent.md`](.claude/agents/codebase-agent.md) for patterns.

### Architecture Patterns

Reference implementations for:
Expand Down Expand Up @@ -115,6 +132,7 @@ GitHub Actions patterns for:
## Documentation

- **[Quickstart](docs/quickstart.md)** - 5-minute introduction to AI-assisted development
- **[Patterns Index](docs/patterns/README.md)** - All workflow patterns in one place
- **[Architecture](docs/architecture.md)** - Common architecture patterns
- **[Tutorial](docs/tutorial.md)** - Step-by-step implementation guide
- **[API Reference](docs/api-reference.md)** - API design patterns
Expand Down