Skip to content

Commit b56bb64

Browse files
vlobachevvlobachev
authored
Merge pull request #1 from vlobachev/claude/upgrade-vibecode-blueprint-E1iJs
feat(agents): modernize AGENTS.md for 2025-2026 agentic coding
2 parents 45ede21 + 8913217 commit b56bb64

65 files changed

Lines changed: 5863 additions & 783 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/settings.local.json‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
{
22
"permissions": {
3-
"allow": [
4-
"Bash(git init:*)"
5-
],
3+
"allow": ["Bash(git init:*)"],
64
"deny": [],
75
"ask": []
86
}
9-
}
7+
}

‎.github/ISSUE_TEMPLATE/agent-bug.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
name: Agent Bug Report
3+
about: Bug fix for AI agents (optimized for agent mode)
4+
title: '[BUG] '
5+
labels: bug, agent-task
6+
assignees: ''
7+
---
8+
9+
## Bug Description
10+
11+
**What's broken**:
12+
13+
**Expected behavior**:
14+
15+
**Actual behavior**:
16+
17+
## Reproduction Steps
18+
19+
1. Step 1
20+
2. Step 2
21+
3. Step 3
22+
4. See error
23+
24+
## Environment
25+
26+
- Environment (dev/staging/prod):
27+
- Browser (if applicable):
28+
- Node version (if applicable):
29+
- Package manager:
30+
31+
## Error Details
32+
33+
**Error message or logs**:
34+
35+
```
36+
Paste error message here
37+
```
38+
39+
**Stack trace** (if available):
40+
41+
```
42+
Paste stack trace here
43+
```
44+
45+
## Acceptance Criteria
46+
47+
**Testable criteria for the fix**:
48+
49+
- [ ] Bug is reproducible with a failing test
50+
- [ ] Fix resolves the issue
51+
- [ ] Test now passes
52+
- [ ] No regression (all existing tests pass)
53+
- [ ] `make validate` passes
54+
- [ ] Root cause documented in PR
55+
56+
## Test Strategy
57+
58+
**How to verify the fix**:
59+
60+
- [ ] Add failing test that reproduces bug
61+
- [ ] Implement fix
62+
- [ ] Verify test now passes
63+
- [ ] Run full test suite (no regressions)
64+
- [ ] Manual verification (if applicable)
65+
66+
## Context
67+
68+
**Related code**:
69+
70+
- Files affected:
71+
- Related issues:
72+
- When did this start:
73+
- Recent changes that might have caused it:
74+
75+
## Root Cause Analysis
76+
77+
**Optional - fill if known**:
78+
79+
- Why did this bug occur:
80+
- What assumption was wrong:
81+
- How to prevent similar bugs:
82+
83+
## Definition of Done
84+
85+
- [ ] Failing test added that reproduces the bug
86+
- [ ] Fix implemented
87+
- [ ] Test now passes
88+
- [ ] No regressions (all other tests pass)
89+
- [ ] `make validate` passes
90+
- [ ] Root cause explained in PR
91+
- [ ] Prevention strategy documented (if applicable)
92+
93+
---
94+
95+
**Agent Guidelines**: Read [AGENTS.md](../../AGENTS.md) before starting. Always
96+
start by adding a failing test that reproduces the bug, then fix it and verify
97+
the test passes.

‎.github/ISSUE_TEMPLATE/agent-feature.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
name: Agent Feature Request
3+
about: Feature implementation for AI agents (optimized for agent mode)
4+
title: '[FEATURE] '
5+
labels: enhancement, agent-task
6+
assignees: ''
7+
---
8+
9+
## Feature Description
10+
11+
**Clear, concise description of what to build**:
12+
13+
## Acceptance Criteria
14+
15+
**Testable, measurable criteria** (check each when complete):
16+
17+
- [ ] Criterion 1
18+
- [ ] Criterion 2
19+
- [ ] Criterion 3
20+
- [ ] All tests pass
21+
- [ ] `make validate` completes successfully
22+
- [ ] Documentation updated
23+
24+
## Test Strategy
25+
26+
**How to verify this works**:
27+
28+
- Unit tests for:
29+
- Integration tests for:
30+
- Edge cases to cover:
31+
32+
## Context
33+
34+
**Links to related code, docs, or designs**:
35+
36+
- Related files:
37+
- Similar patterns:
38+
- Design docs:
39+
- Related issues:
40+
41+
## Implementation Hints
42+
43+
**Optional guidance for the agent**:
44+
45+
- Preferred approach:
46+
- Files to modify:
47+
- Patterns to follow:
48+
- Gotchas to avoid:
49+
50+
## Definition of Done
51+
52+
- [ ] Code implemented following AGENTS.md guidelines
53+
- [ ] Tests written and passing
54+
- [ ] Documentation updated
55+
- [ ] `make validate` passes
56+
- [ ] PR created with checklist complete
57+
- [ ] No security vulnerabilities introduced
58+
59+
---
60+
61+
**Agent Guidelines**: Read [AGENTS.md](../../AGENTS.md) before starting. Follow
62+
the agent-loop pattern: implement → test → fix → repeat until validation passes.

‎.github/ISSUE_TEMPLATE/agent-refactor.md‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
name: Agent Refactoring Task
3+
about: Code refactoring for AI agents (optimized for agent mode)
4+
title: '[REFACTOR] '
5+
labels: refactor, agent-task
6+
assignees: ''
7+
---
8+
9+
## Refactoring Goal
10+
11+
**What to improve and why**:
12+
13+
**Current problem**:
14+
15+
**Desired state**:
16+
17+
## Contracts (Do NOT Break)
18+
19+
**What must remain unchanged**:
20+
21+
- [ ] Public API contracts (interfaces, function signatures)
22+
- [ ] Existing test behavior
23+
- [ ] External integrations
24+
- [ ] User-facing behavior
25+
26+
## Acceptance Criteria
27+
28+
- [ ] Refactoring goal achieved
29+
- [ ] All existing tests still pass (no regressions)
30+
- [ ] Golden tests unchanged (if applicable)
31+
- [ ] `make validate` passes
32+
- [ ] Code coverage maintained or improved
33+
- [ ] Documentation updated
34+
35+
## Refactoring Strategy
36+
37+
**Approach to take**:
38+
39+
1. Step 1
40+
2. Step 2
41+
3. Step 3
42+
43+
**Files to modify**:
44+
45+
-
46+
-
47+
- **Tests to verify**:
48+
49+
-
50+
-
51+
-
52+
53+
## Safety Checks
54+
55+
**Before making changes**:
56+
57+
- [ ] Run full test suite (baseline)
58+
- [ ] Identify all consumers of code being refactored
59+
- [ ] Document current contracts
60+
- [ ] Create golden tests if none exist
61+
62+
**After making changes**:
63+
64+
- [ ] All tests still pass
65+
- [ ] No change in test coverage
66+
- [ ] Golden tests match (no behavior change)
67+
- [ ] Manual verification of affected features
68+
69+
## Context
70+
71+
**Related code**:
72+
73+
- Files to refactor:
74+
- Tests to preserve:
75+
- Consumers to verify:
76+
- Related issues:
77+
78+
## Benefits
79+
80+
**What improves**:
81+
82+
- Performance:
83+
- Maintainability:
84+
- Readability:
85+
- Testability:
86+
- Other:
87+
88+
## Risks
89+
90+
**Potential issues to watch for**:
91+
92+
- Risk 1:
93+
- Risk 2:
94+
- Mitigation strategy:
95+
96+
## Definition of Done
97+
98+
- [ ] Refactoring complete
99+
- [ ] All existing tests pass (no regressions)
100+
- [ ] Golden tests unchanged
101+
- [ ] Code coverage >= baseline
102+
- [ ] `make validate` passes
103+
- [ ] Documentation updated
104+
- [ ] Benefits validated (performance, etc.)
105+
- [ ] No contracts broken
106+
107+
---
108+
109+
**Agent Guidelines**: Read [AGENTS.md](../../AGENTS.md) before starting.
110+
Refactoring MUST NOT break contracts. Run tests before and after. Golden tests
111+
are your regression safety net.

0 commit comments

Comments
 (0)