Skip to content

style(agent-loop): satisfy super-linter (MD040/MD060 + json) #73

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
duyet merged 1 commit into from
Jun 13, 2026
Merged

style(agent-loop): satisfy super-linter (MD040/MD060 + json) #73

Show file tree
Hide file tree
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
2 changes: 1 addition & 1 deletion agent-loop/.claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@
"description": "Continuous agent loop for overnight/day repository maintenance. Orchestrates triage, autoreview, browser automation, and parallel agent work across threads. Wake every 5 min, direct work to threads, land autonomously.",
"author": { "name": "duyetbot" },
"license": "MIT"
}
}
17 changes: 14 additions & 3 deletions agent-loop/.codex-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,19 @@
"license": "MIT",
"skills": "./skills/",
"codex": {
"skills": ["agent-loop-orchestrator", "agent-loop-triage", "agent-loop-autoreview", "agent-loop-browser"],
"commands": ["agent-loop:start", "agent-loop:stop", "agent-loop:status", "agent-loop:triage", "agent-loop:autoreview"]
"skills": [
"agent-loop-orchestrator",
"agent-loop-triage",
"agent-loop-autoreview",
"agent-loop-browser"
],
"commands": [
"agent-loop:start",
"agent-loop:stop",
"agent-loop:status",
"agent-loop:triage",
"agent-loop:autoreview"
]
},
"interface": {
"displayName": "Agent Loop",
Expand All @@ -16,4 +27,4 @@
"category": "Automation",
"capabilities": ["Skill", "Command"]
}
}
}
38 changes: 19 additions & 19 deletions agent-loop/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Continuous overnight/day repository maintenance with autonomous agent loops.

## Plugin Structure

```
```text
agent-loop/
├── .claude-plugin/
│ └── plugin.json # Manifest (version 0.2.0)
Expand All @@ -25,40 +25,40 @@ agent-loop/

### Commands

| Command | Description |
|---------|-------------|
| `/agent-loop:start` | Start the continuous maintenance loop |
| `/agent-loop:stop` | Gracefully stop the loop |
| `/agent-loop:status` | Check loop status and history |
| `/agent-loop:triage` | One-shot repo queue triage |
| `/agent-loop:autoreview` | One-shot PR review and fix |
| Command | Description |
| ------------------------ | ------------------------------------- |
| `/agent-loop:start` | Start the continuous maintenance loop |
| `/agent-loop:stop` | Gracefully stop the loop |
| `/agent-loop:status` | Check loop status and history |
| `/agent-loop:triage` | One-shot repo queue triage |
| `/agent-loop:autoreview` | One-shot PR review and fix |

### Skills

| Skill | Purpose |
|-------|---------|
| Skill | Purpose |
| --------------------------- | ------------------------------------------------------ |
| **agent-loop-orchestrator** | Core loop: wait → triage → dispatch → monitor → report |
| **agent-loop-triage** | GitHub issue/PR queue scanning and classification |
| **agent-loop-autoreview** | Autonomous PR review, fix application, and merging |
| **agent-loop-browser** | Browser automation for live UI proof and verification |
| **agent-loop-triage** | GitHub issue/PR queue scanning and classification |
| **agent-loop-autoreview** | Autonomous PR review, fix application, and merging |
| **agent-loop-browser** | Browser automation for live UI proof and verification |

## Versioning

Follow semantic versioning (semver):

| Change Type | Version Bump | Example |
|-------------|--------------|---------|
| Bug fix, docs | Patch | 0.2.0 → 0.2.1 |
| New feature, minor change | Minor | 0.2.0 → 0.3.0 |
| Breaking change | Major | 0.2.0 → 1.0.0 |
| Change Type | Version Bump | Example |
| ------------------------- | ------------ | ------------- |
| Bug fix, docs | Patch | 0.2.0 → 0.2.1 |
| New feature, minor change | Minor | 0.2.0 → 0.3.0 |
| Breaking change | Major | 0.2.0 → 1.0.0 |

Always update `plugin.json` version when making changes.

## Commit Convention

Use semantic commits with plugin scope:

```
```text
feat(agent-loop): add new feature
fix(agent-loop): fix bug
docs(agent-loop): update documentation
Expand Down
58 changes: 29 additions & 29 deletions agent-loop/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Continuous overnight/day repository maintenance with autonomous agent loops.

```
```text
Wake every 5m ──► Triage repos ──► Dispatch threads ──► Track & land
```

Expand All @@ -25,24 +25,24 @@ That makes it easy to parallelize + steer work as needed.

### Skills

| Skill | Purpose |
|-------|---------|
| Skill | Purpose |
| --------------------------- | ------------------------------------------------------ |
| **agent-loop-orchestrator** | Core loop: wait → triage → dispatch → monitor → report |
| **agent-loop-triage** | GitHub issue/PR queue scanning and classification |
| **agent-loop-autoreview** | Autonomous PR review, fix application, and merging |
| **agent-loop-browser** | Browser automation for live UI proof and verification |
| **agent-loop-triage** | GitHub issue/PR queue scanning and classification |
| **agent-loop-autoreview** | Autonomous PR review, fix application, and merging |
| **agent-loop-browser** | Browser automation for live UI proof and verification |

### Commands

| Command | Description |
|---------|-------------|
| `/agent-loop:start` | Start the continuous maintenance loop |
| `/agent-loop:stop` | Gracefully stop the loop |
| `/agent-loop:status` | Check loop status and history |
| `/agent-loop:triage` | One-shot repo queue triage |
| `/agent-loop:autoreview` | One-shot PR review and fix |
| Command | Description |
| ------------------------ | ------------------------------------- |
| `/agent-loop:start` | Start the continuous maintenance loop |
| `/agent-loop:stop` | Gracefully stop the loop |
| `/agent-loop:status` | Check loop status and history |
| `/agent-loop:triage` | One-shot repo queue triage |
| `/agent-loop:autoreview` | One-shot PR review and fix |

## Skills
## Skill Sources

Sources adapted for the agent-loop plugin:

Expand Down Expand Up @@ -72,18 +72,18 @@ Sources adapted for the agent-loop plugin:

## Configuration

| Env Variable | Default | Description |
|-------------|---------|-------------|
| `AGENT_LOOP_INTERVAL` | 300 | Sleep between cycles (seconds) |
| `AGENT_LOOP_MAX_CONCURRENCY` | 3 | Max parallel worker threads |
| `AGENT_LOOP_SCOPE` | current | Default triage scope |
| `AGENT_LOOP_LOG_DIR` | .agent-loop/logs | Log output directory |
| `AGENT_LOOP_STATE_FILE` | .agent-loop/state.json | Persisted loop state |
| `AGENT_LOOP_REPOS` | (from git remote) | Comma-separated repo list |
| Env Variable | Default | Description |
| ---------------------------- | ---------------------- | ------------------------------ |
| `AGENT_LOOP_INTERVAL` | 300 | Sleep between cycles (seconds) |
| `AGENT_LOOP_MAX_CONCURRENCY` | 3 | Max parallel worker threads |
| `AGENT_LOOP_SCOPE` | current | Default triage scope |
| `AGENT_LOOP_LOG_DIR` | .agent-loop/logs | Log output directory |
| `AGENT_LOOP_STATE_FILE` | .agent-loop/state.json | Persisted loop state |
| `AGENT_LOOP_REPOS` | (from git remote) | Comma-separated repo list |

## Plugin Structure

```
```text
agent-loop/
├── .claude-plugin/
│ └── plugin.json # Manifest (version 0.2.0)
Expand Down Expand Up @@ -111,17 +111,17 @@ agent-loop/

Follow semantic versioning (semver):

| Change Type | Version Bump | Example |
|-------------|--------------|---------|
| Bug fix, docs | Patch | 0.2.0 → 0.2.1 |
| New feature, minor change | Minor | 0.2.0 → 0.3.0 |
| Breaking change | Major | 0.2.0 → 1.0.0 |
| Change Type | Version Bump | Example |
| ------------------------- | ------------ | ------------- |
| Bug fix, docs | Patch | 0.2.0 → 0.2.1 |
| New feature, minor change | Minor | 0.2.0 → 0.3.0 |
| Breaking change | Major | 0.2.0 → 1.0.0 |

## Commit Convention

Use semantic commits with plugin scope:

```
```text
feat(agent-loop): add new feature
fix(agent-loop): fix bug
docs(agent-loop): update documentation
Expand Down
2 changes: 1 addition & 1 deletion agent-loop/commands/status.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Check the current state of the agent-loop.

## Output

```
```text
Agent Loop: RUNNING (PID: 42391)
Started: 2026-06-11 00:00:00 UTC
Uptime: 2h 14m 32s
Expand Down
3 changes: 2 additions & 1 deletion agent-loop/commands/stop.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,8 @@ Gracefully shut down the running agent-loop.
2. Active threads get up to 120s to finish (or 0 with `--force`)
3. Final state is persisted to `.agent-loop/state.json`
4. Prints cycle summary:
```

```text
Agent Loop Stopped
Cycles completed: 24
Items processed: 87
Expand Down
Loading