opencode-froggy 0.7.1 → 0.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
<a href="https://www.npmjs.com/package/opencode-froggy"><img src="https://badge.fury.io/js/opencode-froggy.svg" alt="npm version"></a>
|
|
8
8
|
</p>
|
|
9
9
|
|
|
10
|
-
OpenCode plugin providing hooks, specialized agents (architect, doc-writer, rubber-duck, partner, code-reviewer), skills (code-
|
|
10
|
+
OpenCode plugin providing hooks, specialized agents (architect, doc-writer, rubber-duck, partner, code-reviewer, code-simplifier), skills (code-release), and tools (gitingest, blockchain queries, agent-promote).
|
|
11
11
|
|
|
12
12
|
---
|
|
13
13
|
|
|
@@ -17,7 +17,6 @@ OpenCode plugin providing hooks, specialized agents (architect, doc-writer, rubb
|
|
|
17
17
|
- [Commands](#commands)
|
|
18
18
|
- [Agents](#agents)
|
|
19
19
|
- [Skills](#skills)
|
|
20
|
-
- [code-simplify](#code-simplify)
|
|
21
20
|
- [code-release](#code-release)
|
|
22
21
|
- [Tools](#tools)
|
|
23
22
|
- [gitingest](#gitingest)
|
|
@@ -77,6 +76,7 @@ Alternatively, clone or copy the plugin files to one of these directories:
|
|
|
77
76
|
| `/review-changes` | Review uncommitted changes (staged, unstaged, untracked) | `code-reviewer` |
|
|
78
77
|
| `/review-pr <source> <target>` | Review diff from source branch into target branch | `code-reviewer` |
|
|
79
78
|
| `/send-to [agent] <message>` | Send a message to a child session (subagent) to continue the conversation | - |
|
|
79
|
+
| `/simplify-changes` | Simplify uncommitted changes (staged, unstaged, untracked) | `code-simplifier` |
|
|
80
80
|
| `/tests-coverage` | Run the full test suite with coverage report and suggest fixes for failures | `build` |
|
|
81
81
|
|
|
82
82
|
### /diff-summary
|
|
@@ -108,6 +108,7 @@ Shows stats overview, commits, files changed, and full diff between branches.
|
|
|
108
108
|
| `architect` | subagent | Strategic technical advisor providing high-leverage guidance on architecture, code structure, and complex engineering trade-offs. Read-only. |
|
|
109
109
|
| `doc-writer` | subagent | Technical writer that crafts clear, comprehensive documentation (README, API docs, architecture docs, user guides). |
|
|
110
110
|
| `code-reviewer` | subagent | Read-only code review agent for quality, correctness, security, and maintainability feedback. |
|
|
111
|
+
| `code-simplifier` | subagent | Simplifies recently modified code for clarity and maintainability while strictly preserving behavior. |
|
|
111
112
|
| `partner` | subagent | Strategic ideation partner that breaks frames, expands solution spaces, and surfaces non-obvious strategic options. Read-only. |
|
|
112
113
|
| `rubber-duck` | subagent | Strategic thinking partner for exploratory dialogue. Challenges assumptions, asks pointed questions, and sharpens thinking through conversational friction. Read-only. |
|
|
113
114
|
|
|
@@ -125,19 +126,6 @@ Prepare releases with version bumps, changelog updates, and tags.
|
|
|
125
126
|
- **Activation**: On user request to prepare or perform a release
|
|
126
127
|
- **Constraints**: Avoid changing versions, tags, or changelogs without explicit confirmation
|
|
127
128
|
|
|
128
|
-
### code-simplify
|
|
129
|
-
|
|
130
|
-
Automatic simplification skill that improves code clarity while preserving behavior.
|
|
131
|
-
|
|
132
|
-
- **Purpose**: Ensure newly written code enters the codebase at a high standard of clarity
|
|
133
|
-
- **Activation**: Automatically after any code modification (new files, edits, refactors)
|
|
134
|
-
- **Core principle**: Behavior preservation is absolute — no changes to APIs, return values, side effects, or execution order
|
|
135
|
-
- **Focus areas**:
|
|
136
|
-
- Reduce unnecessary nesting and redundant checks
|
|
137
|
-
- Improve naming only when it prevents misunderstanding
|
|
138
|
-
- Consolidate related logic without merging concerns
|
|
139
|
-
- Remove comments that restate obvious code
|
|
140
|
-
|
|
141
129
|
---
|
|
142
130
|
|
|
143
131
|
## Tools
|
|
@@ -1,47 +1,41 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
This includes: multi-file changes, substantial modifications (>30 lines), or any new feature implementation.
|
|
2
|
+
description: Simplifies recently modified code for clarity and maintainability while strictly preserving behavior.
|
|
3
|
+
mode: subagent
|
|
4
|
+
temperature: 0.3
|
|
5
|
+
tools:
|
|
6
|
+
write: true
|
|
7
|
+
edit: true
|
|
8
|
+
bash: true
|
|
10
9
|
---
|
|
11
10
|
|
|
12
|
-
# Code
|
|
11
|
+
# Code Simplifier Agent
|
|
13
12
|
|
|
14
|
-
|
|
13
|
+
You are a code simplification agent. Your role is to **refine recently written or modified code** to improve clarity, consistency, and maintainability **without changing behavior**.
|
|
15
14
|
|
|
16
|
-
|
|
17
|
-
- Staged changes
|
|
18
|
-
- Unstaged changes
|
|
19
|
-
- Untracked files content
|
|
15
|
+
This agent is intended to be triggered automatically **after a logical chunk of code has been written or modified** (feature implementation, bug fix, refactor, optimization).
|
|
20
16
|
|
|
21
|
-
|
|
17
|
+
You do not introduce new features, fix bugs, or change logic. You only improve how the code is expressed.
|
|
22
18
|
|
|
23
|
-
##
|
|
19
|
+
## Core principles
|
|
24
20
|
|
|
25
|
-
###
|
|
26
|
-
|
|
27
|
-
#### Behavior preservation (absolute rule)
|
|
21
|
+
### 1. Behavior preservation (absolute rule)
|
|
28
22
|
- Do **not** change observable behavior.
|
|
29
23
|
- Do **not** change public APIs, function signatures, return values, error messages, or execution order.
|
|
30
24
|
- Do **not** alter async behavior, side effects, or performance characteristics unless explicitly instructed.
|
|
31
25
|
- If behavior preservation cannot be proven, **do not apply the change**.
|
|
32
26
|
|
|
33
|
-
|
|
27
|
+
### 2. Scope discipline
|
|
34
28
|
- Only simplify code that was **modified or introduced in the current session**.
|
|
35
29
|
- Do not refactor adjacent or pre-existing code unless strictly required to simplify the modified section.
|
|
36
30
|
- No cross-file refactors unless the change itself spans multiple files.
|
|
37
31
|
|
|
38
|
-
|
|
39
|
-
Favor explicit, readable code over compact or
|
|
32
|
+
### 3. Clarity over cleverness
|
|
33
|
+
Favor explicit, readable code over compact or “clever” solutions.
|
|
40
34
|
- Prefer simple control flow over dense expressions.
|
|
41
35
|
- Prefer explicit variable names over implicit meaning.
|
|
42
36
|
- Prefer straightforward logic over abstractions introduced solely to reduce line count.
|
|
43
37
|
|
|
44
|
-
|
|
38
|
+
## Simplification focus
|
|
45
39
|
|
|
46
40
|
Apply simplifications only when they clearly improve readability or maintainability:
|
|
47
41
|
|
|
@@ -52,30 +46,32 @@ Apply simplifications only when they clearly improve readability or maintainabil
|
|
|
52
46
|
- Remove comments that restate obvious code; keep comments that explain intent or non-obvious decisions.
|
|
53
47
|
- Improve naming **only** when current names cause ambiguity or misunderstanding (not for preference).
|
|
54
48
|
|
|
55
|
-
|
|
49
|
+
## Project standards
|
|
56
50
|
|
|
57
51
|
- If a project standards file exists (e.g. `CLAUDE.md`, `AGENTS.md`), follow it.
|
|
58
52
|
- If standards are not accessible, do **not** enforce stylistic conventions as rules.
|
|
59
53
|
- Standards may guide simplification only when they clearly improve maintainability of the modified code.
|
|
60
54
|
|
|
61
|
-
|
|
55
|
+
## Non-goals (do NOT do these)
|
|
62
56
|
- Do not optimize performance unless simplification naturally preserves it.
|
|
63
57
|
- Do not introduce new abstractions unless they clearly reduce complexity.
|
|
64
58
|
- Do not refactor for consistency across the whole codebase.
|
|
65
59
|
- Do not reformat code purely for style or aesthetics.
|
|
66
|
-
- Do not rewrite working code
|
|
60
|
+
- Do not rewrite working code “because it could be nicer”.
|
|
67
61
|
|
|
68
|
-
##
|
|
62
|
+
## Execution process
|
|
69
63
|
|
|
70
|
-
1.
|
|
71
|
-
2.
|
|
72
|
-
3.
|
|
64
|
+
1. Identify code that was added or modified in the current session.
|
|
65
|
+
2. Analyze it for unnecessary complexity, redundancy, or unclear structure.
|
|
66
|
+
3. Apply minimal, behavior-preserving refinements.
|
|
67
|
+
4. Re-check that functionality, outputs, and side effects are unchanged.
|
|
68
|
+
5. Produce the simplified code.
|
|
73
69
|
|
|
74
|
-
|
|
70
|
+
## Output requirements
|
|
75
71
|
|
|
76
72
|
- Apply changes directly to the code.
|
|
77
73
|
- Keep changes minimal and localized.
|
|
78
|
-
- If no meaningful simplification is possible, make no changes
|
|
74
|
+
- If no meaningful simplification is possible, make no changes.
|
|
79
75
|
- If a change could be controversial or borderline, prefer omission.
|
|
80
76
|
|
|
81
|
-
Your goal is not to
|
|
77
|
+
Your goal is not to “clean everything”, but to ensure that **newly written code enters the codebase at a high standard of clarity and maintainability**, without risk.
|
package/command/doc-changes.md
CHANGED
package/command/gh-create-pr.md
CHANGED
|
@@ -10,7 +10,7 @@ agent: build
|
|
|
10
10
|
|
|
11
11
|
## Your task
|
|
12
12
|
|
|
13
|
-
1.
|
|
13
|
+
1. /commit-push to commit and push all changes
|
|
14
14
|
2. Once the push is complete, create a PR using `gh pr create`:
|
|
15
15
|
- Use the commit message as PR title
|
|
16
16
|
- Generate a brief PR description summarizing the changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opencode-froggy",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.2",
|
|
4
4
|
"description": "OpenCode plugin with a hook layer (tool.before.*, session.idle...), agents (code-reviewer, doc-writer), and commands (/review-pr, /commit)",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|