Skip to content

Commit d2a83de

Browse files
committed
common/tasks: New dir, add AI-driven forge review workflow
Add a tasks directory designed primarily for AI agents to execute. These are called "skills" in Claude Code and "commands" in OpenCode, but they're simply structured markdown files. The first task is perform-forge-review.md, which defines an AI-augmented human-approved code review workflow. The key design principle is that the AI builds a review in a local JSONL file, which the human can inspect and edit before submission. The review is submitted as a pending/draft review, allowing the human to make final edits in the forge UI before publishing. Assisted-by: OpenCode (Claude Sonnet 4) Signed-off-by: Colin Walters <walters@verbum.org>
1 parent d5a5a62 commit d2a83de

File tree

8 files changed

+1175
-0
lines changed

8 files changed

+1175
-0
lines changed

common/AGENTS.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,15 @@ looking for any other issues).
3434
If you are performing a review of other's code, the same
3535
principles apply.
3636

37+
## Tasks
38+
39+
The [agents/tasks/](agents/tasks/) directory contains reusable task definitions that you
40+
can execute. These are roughly equivalent to OpenCode "commands" or Claude Code
41+
"skills".
42+
43+
If the user gives an instruction of the form "run task ..." or similar
44+
then you should read the agents/tasks/README.md file and find the relevant task and continue.
45+
3746
## Follow other guidelines
3847

3948
Look at the project README.md and look for guidelines

common/agents/tasks/README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Tasks
2+
3+
Reusable task definitions for AI agents. See [AGENTS.md](../../AGENTS.md)
4+
for how to execute these tasks.
5+
6+
Each `.md` file uses YAML frontmatter (`name`, `description`) followed
7+
by markdown instructions — compatible with Claude Code skills and
8+
OpenCode commands.
9+
10+
## Available Tasks
11+
12+
- **[perform-forge-review](perform-forge-review.md)** — Create AI-assisted code
13+
reviews on GitHub, GitLab, or Forgejo. Builds review comments in a local JSONL
14+
file for human inspection before submitting as a pending/draft review.

0 commit comments

Comments
 (0)