Skip to content

Commit 9b64443

Browse files
jmaglyjmagly
committed
release: v2026.2.4 "Issue Thread"
- /address-issues command with issue-thread-driven ralph loops (#333) - Context window budget configuration (AIWG_CONTEXT_WINDOW) - Release notes, changelog, and announcement doc
1 parent 0be547a commit 9b64443

File tree

3 files changed

+162
-1
lines changed

3 files changed

+162
-1
lines changed

‎CHANGELOG.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,44 @@ All notable changes to the AI Writing Guide (AIWG) project will be documented in
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [2026.2.4] - 2026-02-09 – "Issue Thread" Release
9+
10+
| What changed | Why you care |
11+
|--------------|--------------|
12+
| **`/address-issues` command** | Issue-thread-driven ralph loops with 2-way human-AI collaboration via issue comments |
13+
| **Context window budget** | Configure `AIWG_CONTEXT_WINDOW` to control parallel subagent limits on local/GPU systems |
14+
| **`--interactive` and `--guidance`** | Standard AIWG parameters for discovery prompts and upfront direction |
15+
16+
### Added
17+
18+
**Issue-Driven Ralph Loop** (#333):
19+
20+
- New `/address-issues` command for systematically working through open issues using issue threads as the collaboration surface
21+
- 3-step cycle protocol per issue: work → post structured status comment → scan thread for human feedback
22+
- Thread scanning classifies human comments (feedback, question, approval, correction) and responds substantively
23+
- Multi-issue strategies: sequential (default), batched (related issues), parallel (independent)
24+
- `--interactive` mode: discovery questions before starting, pause between issues for go/no-go
25+
- `--guidance` mode: upfront text direction to tailor prioritization without interactive prompts
26+
- `--branch-per-issue`, `--max-cycles`, `--filter`, `--all-open`, `--provider` parameters
27+
- Issue tracker support: Gitea (MCP tools) and GitHub (`gh` CLI)
28+
- New skill at `agentic/code/frameworks/sdlc-complete/skills/issue-driven-ralph/SKILL.md`
29+
- New command at `agentic/code/frameworks/sdlc-complete/commands/address-issues.md`
30+
- Natural language triggers: "address the open issues", "tackle issue 17", "work on the bug backlog", etc.
31+
- 12 NL phrase mappings added to `docs/simple-language-translations.md`
32+
- Design document at `.aiwg/planning/issue-driven-ralph-loop-design.md`
33+
34+
**Context Window Budget Configuration**:
35+
36+
- New `context-budget.md` rule in `agentic/code/addons/aiwg-utils/rules/` (deploys to all 8 platforms)
37+
- Users set `AIWG_CONTEXT_WINDOW: <tokens>` in CLAUDE.md team directives to declare context budget
38+
- Parallel subagent limits auto-scale: `max_parallel = max(1, floor(context_window / 50000))` capped at 20
39+
- Lookup table: ≤64k→1-2 agents, 65-128k→2-4, 129-256k→4-8, 257-512k→8-12, >512k→12-20
40+
- Compaction guidance: tighter budgets prefer sequential batches, smaller subagent tasks
41+
- Updated `subagent-scoping.md` Rule 7 to reference context budget instead of hardcoded values
42+
- Commented-out `AIWG_CONTEXT_WINDOW` directive added to CLAUDE.md team directives section
43+
44+
---
45+
846
## [2026.2.3] - 2026-02-09 – "Deep Context" Release
947

1048
| What changed | Why you care |

‎docs/releases/v2026.2.4-announcement.md‎

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
# v2026.2.4 - "Issue Thread" Release
2+
3+
**Released**: February 9, 2026
4+
5+
This release introduces the `/address-issues` command — issue-thread-driven ralph loops that turn your issue tracker into a two-way collaboration surface between human and agent. It also adds context window budget configuration so users on local/GPU systems can declare their context limits and have AIWG auto-scale parallel subagent counts.
6+
7+
## Highlights
8+
9+
| What Changed | Why You Care |
10+
|--------------|--------------|
11+
| **`/address-issues` command** | Issue-thread-driven ralph loops with 2-way human-AI collaboration via issue comments |
12+
| **Context window budget** | Configure `AIWG_CONTEXT_WINDOW` to control parallel subagent limits on local/GPU systems |
13+
| **`--interactive` and `--guidance`** | Standard AIWG parameters for discovery prompts and upfront direction |
14+
15+
## Issue-Driven Ralph Loop
16+
17+
The `/address-issues` command transforms the issue tracker from a passive record into an active collaboration surface. Each ralph cycle posts structured status to the issue thread, scans for human feedback, and responds substantively. The human can monitor and steer agent work asynchronously by commenting on the issue — no need to be in the same terminal session.
18+
19+
### The 3-Step Cycle Protocol
20+
21+
```
22+
Step 1: Work — Read issue context, implement fix/feature, run tests
23+
Step 2: Post — Post structured RALPH CYCLE #N status comment to issue thread
24+
Step 3: Scan — Read new thread comments, classify, incorporate into next cycle
25+
```
26+
27+
### Thread Scanning
28+
29+
Human comments are classified and acted on:
30+
31+
| Comment Type | Agent Response |
32+
|-------------|----------------|
33+
| Feedback | Incorporate into next cycle's work |
34+
| Question | Answer in next status comment |
35+
| Approval | Proceed to next phase or close issue |
36+
| Correction | Adjust approach, acknowledge the change |
37+
38+
### Usage
39+
40+
```bash
41+
# Address specific issues
42+
/address-issues 17 18 19
43+
44+
# Work through all open bugs
45+
/address-issues --filter "status:open label:bug"
46+
47+
# Interactive mode with discovery questions
48+
/address-issues --all-open --interactive
49+
50+
# With guidance to tailor priorities
51+
/address-issues --all-open --guidance "Focus on security bugs, skip feature requests"
52+
53+
# Branch per issue with higher cycle limit
54+
/address-issues 17 --branch-per-issue --max-cycles 8
55+
```
56+
57+
### Natural Language Triggers
58+
59+
Say any of these and AIWG routes to `/address-issues`:
60+
61+
- "address the open issues" / "fix open issues"
62+
- "tackle issue 17" / "work on issue 17"
63+
- "work through the bugs" / "work on the bug backlog"
64+
- "go through the open tickets"
65+
- "address issues 17, 18, 19 interactively"
66+
- "fix the open bugs, focus on security issues first"
67+
68+
### What's Included
69+
70+
| Type | Artifact |
71+
|------|----------|
72+
| Command | `/address-issues` with full parameter support |
73+
| Skill | `issue-driven-ralph` with NL trigger matching |
74+
| NL Mappings | 12 phrase-to-command translations |
75+
| Design Doc | `.aiwg/planning/issue-driven-ralph-loop-design.md` |
76+
| Providers | Gitea (MCP tools) and GitHub (`gh` CLI) |
77+
78+
## Context Window Budget Configuration
79+
80+
Users running Claude Code on local GPU systems with smaller context windows (e.g., 100k tokens) can now declare their budget. The framework auto-scales parallel subagent limits accordingly.
81+
82+
### Configuration
83+
84+
Add to your CLAUDE.md team directives section:
85+
86+
```markdown
87+
AIWG_CONTEXT_WINDOW: 100000
88+
```
89+
90+
### Auto-Scaling Table
91+
92+
| Context Window | Max Parallel Subagents | Compaction Behavior |
93+
|----------------|----------------------|---------------------|
94+
| Unset (default) | No limit (platform decides) | Normal |
95+
| ≤64k | 1-2 | Aggressive — prefer sequential |
96+
| 65k-128k | 2-4 | Moderate — batch in groups of 2-3 |
97+
| 129k-256k | 4-8 | Standard |
98+
| 257k-512k | 8-12 | Relaxed |
99+
| >512k | 12-20 | Normal (cloud default) |
100+
101+
**Formula**: `max_parallel = max(1, floor(context_window / 50000))` capped at 20.
102+
103+
### What's Included
104+
105+
| Type | Artifact |
106+
|------|----------|
107+
| Rule | `context-budget.md` (deploys to all 8 platforms) |
108+
| Updated Rule | `subagent-scoping.md` Rule 7 references context budget |
109+
| CLAUDE.md | Commented-out `AIWG_CONTEXT_WINDOW` directive |
110+
111+
## Install / Upgrade
112+
113+
```bash
114+
npm install -g aiwg@2026.2.4
115+
```
116+
117+
## Links
118+
119+
- [CHANGELOG](../../CHANGELOG.md)
120+
- [Address Issues Command](../../agentic/code/frameworks/sdlc-complete/commands/address-issues.md)
121+
- [Issue-Driven Ralph Skill](../../agentic/code/frameworks/sdlc-complete/skills/issue-driven-ralph/SKILL.md)
122+
- [Context Budget Rule](../../agentic/code/addons/aiwg-utils/rules/context-budget.md)
123+
- [NL Translations](../simple-language-translations.md)

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "aiwg",
3-
"version": "2026.2.3",
3+
"version": "2026.2.4",
44
"description": "Cognitive architecture for AI-augmented software development with structured memory, ensemble validation, and closed-loop correction. FAIR-aligned artifacts, 84% cost reduction via human-in-the-loop, standards adopted by 100+ organizations.",
55
"type": "module",
66
"bin": {

0 commit comments

Comments
 (0)