@hopla/claude-setup 1.0.9 → 1.1.1
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
|
@@ -95,6 +95,49 @@ CLAUDE.md (project root) ← Project-specific rules (created with /hopla-init-
|
|
|
95
95
|
|
|
96
96
|
---
|
|
97
97
|
|
|
98
|
+
## Command Chaining
|
|
99
|
+
|
|
100
|
+
Commands are modular — the output of one becomes the input of the next. Some commands accept arguments (`$1`, `$2`) to receive files generated by previous commands.
|
|
101
|
+
|
|
102
|
+
### Commands that accept arguments
|
|
103
|
+
|
|
104
|
+
| Command | Argument | Example |
|
|
105
|
+
|---|---|---|
|
|
106
|
+
| `/hopla-execute` | Path to plan file | `/hopla-execute .agents/plans/auth-feature.md` |
|
|
107
|
+
| `/hopla-code-review-fix` | Path to review report or description | `/hopla-code-review-fix .agents/code-reviews/auth-review.md` |
|
|
108
|
+
| `/hopla-system-review` | Plan file + execution report | `/hopla-system-review .agents/plans/auth-feature.md .agents/execution-reports/auth-feature.md` |
|
|
109
|
+
|
|
110
|
+
### Full PIV loop example
|
|
111
|
+
|
|
112
|
+
```
|
|
113
|
+
# 1. Plan
|
|
114
|
+
/hopla-plan-feature add user authentication
|
|
115
|
+
→ saves: .agents/plans/add-user-authentication.md
|
|
116
|
+
|
|
117
|
+
# 2. Execute
|
|
118
|
+
/hopla-execute .agents/plans/add-user-authentication.md
|
|
119
|
+
→ implements the plan, runs validation
|
|
120
|
+
|
|
121
|
+
# 3. Review
|
|
122
|
+
/hopla-code-review
|
|
123
|
+
→ saves: .agents/code-reviews/add-user-authentication.md
|
|
124
|
+
|
|
125
|
+
# 4. Fix issues
|
|
126
|
+
/hopla-code-review-fix .agents/code-reviews/add-user-authentication.md
|
|
127
|
+
|
|
128
|
+
# 5. Commit
|
|
129
|
+
/hopla-commit
|
|
130
|
+
|
|
131
|
+
# 6. Document
|
|
132
|
+
/hopla-execution-report
|
|
133
|
+
→ saves: .agents/execution-reports/add-user-authentication.md
|
|
134
|
+
|
|
135
|
+
# 7. Improve process
|
|
136
|
+
/hopla-system-review .agents/plans/add-user-authentication.md .agents/execution-reports/add-user-authentication.md
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
98
141
|
## Project Structure (after /hopla-init-project)
|
|
99
142
|
|
|
100
143
|
```
|
|
@@ -9,6 +9,8 @@ Perform a technical code review focused on finding real bugs and issues.
|
|
|
9
9
|
|
|
10
10
|
Read `CLAUDE.md` or `AGENTS.md` to understand project standards and patterns.
|
|
11
11
|
|
|
12
|
+
If `.agents/guides/` exists, read any guides relevant to the files being reviewed (e.g. `@.agents/guides/api-guide.md` when reviewing API changes). These guides define the expected patterns for specific task types.
|
|
13
|
+
|
|
12
14
|
## Step 2: Identify Changed Files
|
|
13
15
|
|
|
14
16
|
```bash
|
|
@@ -11,6 +11,7 @@ Read in this order:
|
|
|
11
11
|
1. **$1** — The plan file (read it entirely before writing a single line of code)
|
|
12
12
|
2. `CLAUDE.md` or `AGENTS.md` at project root — rules and patterns to follow
|
|
13
13
|
3. All files listed in the plan's **Context References** section
|
|
14
|
+
4. Any `.agents/guides/` files referenced in the plan or relevant to the tasks (e.g. `@.agents/guides/api-guide.md`)
|
|
14
15
|
|
|
15
16
|
Do not start implementing until you have read everything above.
|
|
16
17
|
|
|
@@ -98,6 +99,6 @@ Provide a summary of what was done:
|
|
|
98
99
|
## Step 6: Suggest Next Steps
|
|
99
100
|
|
|
100
101
|
After the summary, suggest:
|
|
101
|
-
1. Run `/execution-report` to document this implementation for system review
|
|
102
|
-
2. Run `/code-review` for a technical quality check
|
|
103
|
-
3. Run `/commit` once everything is approved
|
|
102
|
+
1. Run `/hopla-execution-report` to document this implementation for system review
|
|
103
|
+
2. Run `/hopla-code-review` for a technical quality check
|
|
104
|
+
3. Run `/hopla-commit` once everything is approved
|
|
@@ -22,6 +22,7 @@ Read the following to understand the project:
|
|
|
22
22
|
1. `CLAUDE.md` or `AGENTS.md` at project root — architecture rules, patterns, constraints
|
|
23
23
|
2. `README.md` — project overview and setup
|
|
24
24
|
3. `package.json` or `pyproject.toml` — stack, dependencies, scripts
|
|
25
|
+
4. `.agents/guides/` — if this directory exists, read any guides relevant to the feature being planned (e.g. `@.agents/guides/api-guide.md` when planning an API endpoint)
|
|
25
26
|
|
|
26
27
|
Then run:
|
|
27
28
|
|
|
@@ -133,4 +134,4 @@ Confirm to the user:
|
|
|
133
134
|
- Plan saved to: `.agents/plans/[feature-name].md`
|
|
134
135
|
- Summary of tasks included
|
|
135
136
|
- Any open questions or decisions that require human confirmation before execution
|
|
136
|
-
- Suggest running `/commit` to save the plan to the repository
|
|
137
|
+
- Suggest running `/hopla-commit` to save the plan to the repository
|