@hopla/claude-setup 1.1.2 → 1.1.3
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 +30 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -47,6 +47,36 @@ CLAUDE.md (project root) ← Project-specific rules (created with /hopla-init-
|
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
+
## The Agentic Coding Framework
|
|
51
|
+
|
|
52
|
+
This system is built on two core concepts from the Agentic Coding Course:
|
|
53
|
+
|
|
54
|
+
### AI Layer — What guides the agent
|
|
55
|
+
|
|
56
|
+
| Pillar | What it is | Where it lives |
|
|
57
|
+
|--------|-----------|----------------|
|
|
58
|
+
| **Global Rules** | Always-loaded context: language, git flow, tech defaults, autonomy rules | `~/.claude/CLAUDE.md` |
|
|
59
|
+
| **On-Demand Context** | Task-specific guides loaded when needed (e.g. "how to add an API endpoint") | `.agents/guides/*.md` |
|
|
60
|
+
| **Commands** | Reusable processes that tell the agent *how* to work | `~/.claude/commands/hopla-*.md` |
|
|
61
|
+
|
|
62
|
+
The key insight: **commands inject on-demand context deterministically** — when you run `/hopla-plan-feature`, it automatically reads the relevant guide from `.agents/guides/` before planning.
|
|
63
|
+
|
|
64
|
+
### PIV Loop — How you work
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
Plan → Implement → Validate → (repeat)
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
- **Plan** (`/hopla-plan-feature`) — Research the codebase, design the approach, create a structured plan
|
|
71
|
+
- **Implement** (`/hopla-execute`) — Delegate coding to the AI, trust but verify at each task
|
|
72
|
+
- **Validate** — AI runs lint → types → tests → integration; human reviews the result
|
|
73
|
+
|
|
74
|
+
### System Evolution
|
|
75
|
+
|
|
76
|
+
After each PIV loop, run `/hopla-execution-report` + `/hopla-system-review` to find process improvements. Don't just fix bugs — fix the system that allowed them.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
50
80
|
## What Gets Installed
|
|
51
81
|
|
|
52
82
|
**`~/.claude/CLAUDE.md`** — Global rules applied to every Claude Code session.
|