@softspark/ai-toolkit 1.0.0 → 1.2.0
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/CHANGELOG.md +34 -1
- package/README.md +22 -12
- package/app/.claude-plugin/plugin.json +2 -2
- package/app/ARCHITECTURE.md +7 -5
- package/app/hooks/pre-compact.sh +44 -10
- package/app/personas/backend-lead.md +27 -0
- package/app/personas/devops-eng.md +27 -0
- package/app/personas/frontend-lead.md +26 -0
- package/app/personas/junior-dev.md +28 -0
- package/app/rules/claude-toolkit-rules.md +1 -1
- package/app/skills/api-patterns/SKILL.md +1 -0
- package/app/skills/app-builder/SKILL.md +1 -0
- package/app/skills/ci-cd-patterns/SKILL.md +1 -0
- package/app/skills/clean-code/SKILL.md +1 -0
- package/app/skills/csharp-patterns/SKILL.md +1 -0
- package/app/skills/database-patterns/SKILL.md +1 -0
- package/app/skills/debugging-tactics/SKILL.md +1 -1
- package/app/skills/design-engineering/SKILL.md +1 -0
- package/app/skills/docker-devops/SKILL.md +1 -0
- package/app/skills/documentation-standards/SKILL.md +1 -0
- package/app/skills/ecommerce-patterns/SKILL.md +1 -0
- package/app/skills/flutter-patterns/SKILL.md +1 -0
- package/app/skills/git-mastery/SKILL.md +1 -1
- package/app/skills/hive-mind/SKILL.md +1 -0
- package/app/skills/java-patterns/SKILL.md +1 -0
- package/app/skills/kotlin-patterns/SKILL.md +1 -0
- package/app/skills/mcp-patterns/SKILL.md +1 -0
- package/app/skills/migration-patterns/SKILL.md +1 -0
- package/app/skills/observability-patterns/SKILL.md +1 -0
- package/app/skills/onboard/SKILL.md +2 -0
- package/app/skills/orchestrate/SKILL.md +1 -1
- package/app/skills/performance-profiling/SKILL.md +1 -1
- package/app/skills/persona/SKILL.md +57 -0
- package/app/skills/plan-writing/SKILL.md +1 -0
- package/app/skills/pr/scripts/pr-summary.py +6 -3
- package/app/skills/rag-patterns/SKILL.md +1 -0
- package/app/skills/research-mastery/SKILL.md +1 -0
- package/app/skills/ruby-patterns/SKILL.md +1 -0
- package/app/skills/rust-patterns/SKILL.md +1 -0
- package/app/skills/security-patterns/SKILL.md +1 -0
- package/app/skills/skill-audit/SKILL.md +137 -0
- package/app/skills/subagent-development/SKILL.md +1 -1
- package/app/skills/swarm/SKILL.md +1 -1
- package/app/skills/swift-patterns/SKILL.md +1 -1
- package/app/skills/teams/SKILL.md +1 -1
- package/app/skills/testing-patterns/SKILL.md +1 -0
- package/app/skills/typescript-patterns/SKILL.md +1 -0
- package/app/skills/verification-before-completion/SKILL.md +1 -0
- package/app/skills/workflow/SKILL.md +1 -1
- package/kb/reference/architecture-overview.md +28 -5
- package/kb/reference/hooks-catalog.md +6 -4
- package/kb/reference/skills-catalog.md +5 -3
- package/llms.txt +2 -2
- package/package.json +3 -2
- package/scripts/audit_skills.py +290 -0
- package/scripts/generate_augment.py +46 -0
- package/scripts/install.py +32 -2
- package/scripts/install_steps/ai_tools.py +10 -1
- package/scripts/install_steps/hooks.py +30 -0
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,39 @@ Versioning follows [Semantic Versioning](https://semver.org/).
|
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
+
## [1.2.0] - 2026-04-03
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- **`/skill-audit` skill** — security scanner for skills and agents: detects dangerous code patterns (`eval`, `exec`, `os.system`), hardcoded secrets (AWS keys, GitHub PATs, private keys), overly permissive `allowed-tools`, and missing safety constraints. Supports `--fix` for auto-remediation of safe issues. CI-ready (non-zero exit on HIGH findings).
|
|
14
|
+
- **Persona presets** (`--persona` flag) — 4 engineering personas: `backend-lead`, `frontend-lead`, `devops-eng`, `junior-dev`. Each injects role-specific communication style, preferred skills, and code review priorities into CLAUDE.md. Usage: `ai-toolkit install --persona backend-lead`.
|
|
15
|
+
- **`/persona` runtime switching** — new hybrid skill to switch persona at runtime without re-install. Usage: `/persona backend-lead`, `/persona --list`, `/persona --clear`. Session-scoped.
|
|
16
|
+
- **Augment editor support** — `scripts/generate_augment.py` generates `.augment/rules/ai-toolkit.md` with proper frontmatter (`type: always_apply`). Registered in global install.
|
|
17
|
+
- **`scripts/audit_skills.py`** — deterministic Python scanner for CI pipelines. Scans skills/agents for dangerous patterns, secrets, permission issues. JSON output (`--json`), non-zero exit on HIGH (`--ci`). Found 4 real HIGH findings in our own toolkit.
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
- **Smart compaction** (`pre-compact.sh`) — enhanced with prioritized context preservation: instincts (with confidence scores) > session context > git state (branch, dirty files, last commit) > key decisions. Replaces flat output with structured sections.
|
|
21
|
+
- Editor count: 8 → 9 (added Augment)
|
|
22
|
+
- Skill count: 85 → 87 (added `skill-audit`, `persona`)
|
|
23
|
+
- Task skill count: 27 → 28 (`skill-audit`)
|
|
24
|
+
- Hybrid skill count: 27 → 28 (`persona`)
|
|
25
|
+
|
|
26
|
+
[1.2.0]: https://github.com/softspark/ai-toolkit/releases/tag/v1.2.0
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## [1.1.0] - 2026-04-02
|
|
31
|
+
|
|
32
|
+
### Added
|
|
33
|
+
- **Agent Teams auto-enabled** — `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` is now automatically set in `~/.claude/settings.json` via `env` field during `install` / `update`. No manual `export` needed.
|
|
34
|
+
- 2 new install tests: env var injection + user env var preservation
|
|
35
|
+
|
|
36
|
+
### Fixed
|
|
37
|
+
- README test badge count: 308 → 310
|
|
38
|
+
|
|
39
|
+
[1.1.0]: https://github.com/softspark/ai-toolkit/releases/tag/v1.1.0
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
10
43
|
## [1.0.0] - 2026-04-02
|
|
11
44
|
|
|
12
45
|
### Added
|
|
@@ -46,7 +79,7 @@ Versioning follows [Semantic Versioning](https://semver.org/).
|
|
|
46
79
|
- CI: auto-regenerate `AGENTS.md` and `llms.txt` on push to main; publish on tags
|
|
47
80
|
- **DRY refactoring**: `scripts/_common.py` shared library for all generators and CLI scripts; `app/hooks/_profile-check.sh` for 9 hooks; CLI uses data-driven `GENERATORS` map
|
|
48
81
|
- All hooks standardized to `#!/usr/bin/env bash` shebang
|
|
49
|
-
-
|
|
82
|
+
- 310 tests across 16 test files
|
|
50
83
|
- **Iron Law enforcement** in TDD, debugging, and verification skills — anti-rationalization tables prevent agents from skipping test-first, root-cause analysis, or claiming completion without evidence
|
|
51
84
|
- **`/subagent-development`** — 2-stage review workflow: dispatch implementer → spec compliance review → code quality review per task, with 4-status protocol (DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, BLOCKED) and prompt templates
|
|
52
85
|
- **`/repeat`** — Ralph Wiggum autonomous loop pattern with safety controls: max iterations (default 5), circuit breaker (3 consecutive failures → halt), min interval (1 minute), exit detection, stats logging
|
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# ai-toolkit
|
|
2
2
|
|
|
3
|
-
> Professional-grade AI coding toolkit with multi-platform support. Machine-enforced safety,
|
|
3
|
+
> Professional-grade AI coding toolkit with multi-platform support. Machine-enforced safety, 87 skills, 47 agents, expanded lifecycle hooks, persona presets, experimental opt-in plugin packs, and benchmark tooling — works with Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, and Augment, ready in 60 seconds.
|
|
4
4
|
|
|
5
5
|
[](https://github.com/softspark/ai-toolkit/actions/workflows/ci.yml)
|
|
6
6
|
[](LICENSE)
|
|
7
|
-
[](app/skills/)
|
|
8
8
|
[](app/agents/)
|
|
9
|
-
[](tests/)
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -21,7 +21,7 @@ ai-toolkit install
|
|
|
21
21
|
npx @softspark/ai-toolkit install
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
-
**That's it.** Claude Code picks up
|
|
24
|
+
**That's it.** Claude Code picks up 87 skills, 47 agents, quality hooks, and the safety constitution automatically.
|
|
25
25
|
|
|
26
26
|
### Update
|
|
27
27
|
|
|
@@ -59,6 +59,17 @@ ai-toolkit install --profile standard # full install (default)
|
|
|
59
59
|
ai-toolkit install --profile strict # full install + git hooks even without --local
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
+
### Persona Presets
|
|
63
|
+
|
|
64
|
+
Inject role-specific communication style and skill preferences:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
ai-toolkit install --persona backend-lead # system design, API stability, data integrity
|
|
68
|
+
ai-toolkit install --persona frontend-lead # component architecture, a11y, Core Web Vitals
|
|
69
|
+
ai-toolkit install --persona devops-eng # infra-as-code, CI/CD, rollback safety
|
|
70
|
+
ai-toolkit install --persona junior-dev # step-by-step explanations, learning focus
|
|
71
|
+
```
|
|
72
|
+
|
|
62
73
|
### Selective Install / Update
|
|
63
74
|
|
|
64
75
|
```bash
|
|
@@ -111,8 +122,8 @@ Replaces all symlinks with real files, inlines rules into CLAUDE.md, copies cons
|
|
|
111
122
|
|
|
112
123
|
| Component | Count | Description |
|
|
113
124
|
|-----------|-------|-------------|
|
|
114
|
-
| `skills/` (task) |
|
|
115
|
-
| `skills/` (hybrid) |
|
|
125
|
+
| `skills/` (task) | 28 | Slash commands: `/commit`, `/build`, `/deploy`, `/test`, `/skill-audit`, ... |
|
|
126
|
+
| `skills/` (hybrid) | 28 | Slash commands with agent knowledge base |
|
|
116
127
|
| `skills/` (knowledge) | 31 | Domain knowledge auto-loaded by agents |
|
|
117
128
|
| `agents/` | 47 | Specialized agents across 10 categories |
|
|
118
129
|
| `hooks/` | 15 global + 5 skill-scoped | Quality gates, path safety, CLAUDE.md enforcement, notifications, prompt governance, subagent lifecycle, session-end handoff, usage tracking |
|
|
@@ -134,7 +145,7 @@ ai-toolkit/
|
|
|
134
145
|
│ │ ├── backend-specialist.md
|
|
135
146
|
│ │ ├── security-architect.md
|
|
136
147
|
│ │ └── ... (44 more)
|
|
137
|
-
│ ├── skills/ #
|
|
148
|
+
│ ├── skills/ # 87 skills (task / hybrid / knowledge)
|
|
138
149
|
│ │ ├── commit/ # /commit slash command
|
|
139
150
|
│ │ ├── review/ # /review slash command
|
|
140
151
|
│ │ ├── clean-code/ # knowledge skill (auto-loaded)
|
|
@@ -192,6 +203,7 @@ ai-toolkit/
|
|
|
192
203
|
| `/command-creator` | Scaffold a new slash command with frontmatter and workflow guidance | high |
|
|
193
204
|
| `/agent-creator` | Scaffold a new specialized agent with tools and trigger guidance | high |
|
|
194
205
|
| `/plugin-creator` | Scaffold an experimental plugin pack with manifest and optional modules | high |
|
|
206
|
+
| `/skill-audit` | Scan skills/agents for security risks: dangerous patterns, secrets, permissions | medium |
|
|
195
207
|
| `/analyze` | Code quality, complexity, and pattern analysis | medium |
|
|
196
208
|
| `/fix` | Auto-fix lint/type errors | low |
|
|
197
209
|
| `/build` | Build with issue detection | low |
|
|
@@ -416,11 +428,7 @@ All packs have `status: experimental`. Each has a `plugin.json` manifest and `RE
|
|
|
416
428
|
|
|
417
429
|
## Agent Teams
|
|
418
430
|
|
|
419
|
-
Native support for `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
|
420
|
-
|
|
421
|
-
```bash
|
|
422
|
-
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
|
423
|
-
```
|
|
431
|
+
Native support for `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` — automatically enabled during `ai-toolkit install` / `update` via `env` in `~/.claude/settings.json`.
|
|
424
432
|
|
|
425
433
|
Pre-configured team presets via `/teams`:
|
|
426
434
|
|
|
@@ -567,6 +575,7 @@ Usage: ai-toolkit <command> [options]
|
|
|
567
575
|
| `cline-rules` | Generate `.clinerules` in current dir |
|
|
568
576
|
| `roo-modes` | Generate `.roomodes` in current dir |
|
|
569
577
|
| `aider-conf` | Generate `.aider.conf.yml` in current dir |
|
|
578
|
+
| `augment-rules` | Generate `.augment/rules/ai-toolkit.md` in current dir |
|
|
570
579
|
| `agents-md` | Regenerate `AGENTS.md` from agent definitions |
|
|
571
580
|
| `llms-txt` | Generate `llms.txt` and `llms-full.txt` |
|
|
572
581
|
| `generate-all` | Generate all platform configs at once |
|
|
@@ -578,6 +587,7 @@ Usage: ai-toolkit <command> [options]
|
|
|
578
587
|
ai-toolkit install --only agents,hooks # apply only listed components
|
|
579
588
|
ai-toolkit install --skip hooks # skip listed components
|
|
580
589
|
ai-toolkit install --profile minimal # profile preset: minimal | standard | strict
|
|
590
|
+
ai-toolkit install --persona backend-lead # persona preset: backend-lead | frontend-lead | devops-eng | junior-dev
|
|
581
591
|
ai-toolkit install --local # also set up project-local configs (CLAUDE.md, settings, constitution, Copilot, Cline, Roo, Aider, Git Hooks, MCP Defaults)
|
|
582
592
|
ai-toolkit update --local # re-apply + refresh project-local configs
|
|
583
593
|
ai-toolkit install --list # dry-run: show what would be applied
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ai-toolkit",
|
|
3
|
-
"description": "Professional-grade Claude Code toolkit:
|
|
4
|
-
"version": "1.
|
|
3
|
+
"description": "Professional-grade Claude Code toolkit: 87 skills, 47 agents, persona presets, skill security auditor, expanded lifecycle hooks, experimental opt-in plugin packs, benchmark harvesting, and multi-tool support.",
|
|
4
|
+
"version": "1.2.0",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "SoftSpark",
|
|
7
7
|
"url": "https://github.com/softspark"
|
package/app/ARCHITECTURE.md
CHANGED
|
@@ -7,7 +7,7 @@ Universal multi-agent system for software development. Works across all reposito
|
|
|
7
7
|
| Component | Count |
|
|
8
8
|
|-----------|-------|
|
|
9
9
|
| Agents | 47 |
|
|
10
|
-
| Skills |
|
|
10
|
+
| Skills | 87 |
|
|
11
11
|
| Hooks | 12 events / 15 entries (SessionStart, Notification, PreToolUse ×2, UserPromptSubmit ×2, PostToolUse, Stop ×2, TaskCompleted, TeammateIdle, SubagentStart, SubagentStop, PreCompact, SessionEnd) |
|
|
12
12
|
|
|
13
13
|
---
|
|
@@ -103,9 +103,9 @@ Universal multi-agent system for software development. Works across all reposito
|
|
|
103
103
|
|
|
104
104
|
---
|
|
105
105
|
|
|
106
|
-
## Skills (
|
|
106
|
+
## Skills (87)
|
|
107
107
|
|
|
108
|
-
### Task Skills (
|
|
108
|
+
### Task Skills (28)
|
|
109
109
|
| Skill | Slash Command | Purpose |
|
|
110
110
|
|-------|---------------|---------|
|
|
111
111
|
| `commit` | `/commit` | Create well-structured git commits (Conventional Commits) |
|
|
@@ -135,8 +135,9 @@ Universal multi-agent system for software development. Works across all reposito
|
|
|
135
135
|
| `agent-creator` | `/agent-creator` | Create new specialized agents with tools and trigger guidance |
|
|
136
136
|
| `plugin-creator` | `/plugin-creator` | Create experimental opt-in plugin packs with manifests, conventions, and optional modules |
|
|
137
137
|
| `prd-to-issues` | `/prd-to-issues` | Break PRD into GitHub issues with vertical slices and HITL/AFK tagging |
|
|
138
|
+
| `skill-audit` | `/skill-audit` | Scan skills and agents for security risks, dangerous patterns, secrets |
|
|
138
139
|
|
|
139
|
-
### Hybrid Skills (
|
|
140
|
+
### Hybrid Skills (28)
|
|
140
141
|
| Skill | Slash Command | Purpose |
|
|
141
142
|
|-------|---------------|---------|
|
|
142
143
|
| `explore` | `/explore` | Codebase exploration and tech stack discovery |
|
|
@@ -166,6 +167,7 @@ Universal multi-agent system for software development. Works across all reposito
|
|
|
166
167
|
| `subagent-development` | `/subagent-development` | Execute plans with 2-stage review (spec + quality) per task |
|
|
167
168
|
| `repeat` | `/repeat` | Autonomous loop with safety controls (Ralph Wiggum pattern) |
|
|
168
169
|
| `mem-search` | `/mem-search` | Search past coding sessions via natural language (memory-pack) |
|
|
170
|
+
| `persona` | `/persona` | Switch engineering persona at runtime (backend-lead, frontend-lead, devops-eng, junior-dev) |
|
|
169
171
|
|
|
170
172
|
### Knowledge Skills - Development (15)
|
|
171
173
|
| Skill | Purpose |
|
|
@@ -255,7 +257,7 @@ Phase 2: IMPLEMENTATION
|
|
|
255
257
|
├── ARCHITECTURE.md # This file
|
|
256
258
|
├── agents/ # Agent definitions (47)
|
|
257
259
|
├── hooks.json # Quality gate hooks (multi-language)
|
|
258
|
-
├── skills/ # All skills: task, hybrid, knowledge (
|
|
260
|
+
├── skills/ # All skills: task, hybrid, knowledge (87)
|
|
259
261
|
├── output-styles/ # System prompt output style overrides (e.g. golden-rules)
|
|
260
262
|
├── constitution.md # Immutable safety rules (5 articles)
|
|
261
263
|
└── settings.local.json # Local settings + Agent Teams config
|
package/app/hooks/pre-compact.sh
CHANGED
|
@@ -3,29 +3,63 @@
|
|
|
3
3
|
#
|
|
4
4
|
# Fires on: PreCompact
|
|
5
5
|
# Outputs key context markers so they survive the compaction boundary.
|
|
6
|
+
# Priority order: rules > instincts > tasks > session context > git state.
|
|
6
7
|
# Skipped when TOOLKIT_HOOK_PROFILE=minimal.
|
|
7
8
|
|
|
8
9
|
# shellcheck source=_profile-check.sh
|
|
9
10
|
source "$(dirname "$0")/_profile-check.sh"
|
|
10
11
|
|
|
11
|
-
#
|
|
12
|
+
# ---------------------------------------------------------------------------
|
|
13
|
+
# 1. Mandatory reload reminder (highest priority — always survives)
|
|
14
|
+
# ---------------------------------------------------------------------------
|
|
12
15
|
echo "IMPORTANT: Context was compacted. Re-read CLAUDE.md files and active tasks before continuing."
|
|
13
16
|
|
|
14
|
-
#
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
cat ".claude/session-context.md"
|
|
18
|
-
echo "=============================="
|
|
19
|
-
fi
|
|
20
|
-
|
|
21
|
-
# 3. Preserve active instincts
|
|
17
|
+
# ---------------------------------------------------------------------------
|
|
18
|
+
# 2. Active instincts (high priority — behavioral rules)
|
|
19
|
+
# ---------------------------------------------------------------------------
|
|
22
20
|
INSTINCTS_DIR=".claude/instincts"
|
|
23
21
|
if [ -d "$INSTINCTS_DIR" ] && ls "$INSTINCTS_DIR"/*.md >/dev/null 2>&1; then
|
|
24
22
|
echo "=== Active Instincts ==="
|
|
25
23
|
for f in "$INSTINCTS_DIR"/*.md; do
|
|
26
|
-
|
|
24
|
+
# Extract pattern name and confidence from first two lines
|
|
25
|
+
name=$(head -1 "$f" | sed 's/^# Pattern: //')
|
|
26
|
+
confidence=$(grep -m1 'Confidence:' "$f" | awk '{print $2}')
|
|
27
|
+
echo "- [${confidence:-?}] $name"
|
|
27
28
|
done
|
|
28
29
|
echo "========================"
|
|
29
30
|
fi
|
|
30
31
|
|
|
32
|
+
# ---------------------------------------------------------------------------
|
|
33
|
+
# 3. Current task state (medium priority — what we're doing)
|
|
34
|
+
# ---------------------------------------------------------------------------
|
|
35
|
+
if [ -f ".claude/session-context.md" ]; then
|
|
36
|
+
echo "=== Session Context ==="
|
|
37
|
+
cat ".claude/session-context.md"
|
|
38
|
+
echo "======================="
|
|
39
|
+
fi
|
|
40
|
+
|
|
41
|
+
# ---------------------------------------------------------------------------
|
|
42
|
+
# 4. Git working state (low priority — quick orientation)
|
|
43
|
+
# ---------------------------------------------------------------------------
|
|
44
|
+
if command -v git >/dev/null 2>&1 && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
|
|
45
|
+
BRANCH=$(git branch --show-current 2>/dev/null)
|
|
46
|
+
DIRTY=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
|
|
47
|
+
LAST_COMMIT=$(git log -1 --oneline 2>/dev/null)
|
|
48
|
+
echo "=== Git State ==="
|
|
49
|
+
echo "Branch: ${BRANCH:-detached}"
|
|
50
|
+
echo "Uncommitted changes: ${DIRTY}"
|
|
51
|
+
echo "Last commit: ${LAST_COMMIT}"
|
|
52
|
+
echo "================="
|
|
53
|
+
fi
|
|
54
|
+
|
|
55
|
+
# ---------------------------------------------------------------------------
|
|
56
|
+
# 5. Key decisions file (if user has been noting decisions this session)
|
|
57
|
+
# ---------------------------------------------------------------------------
|
|
58
|
+
if [ -f ".claude/decisions.md" ]; then
|
|
59
|
+
echo "=== Key Decisions This Session ==="
|
|
60
|
+
# Only show last 10 lines to keep token budget tight
|
|
61
|
+
tail -10 ".claude/decisions.md"
|
|
62
|
+
echo "=================================="
|
|
63
|
+
fi
|
|
64
|
+
|
|
31
65
|
exit 0
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Persona: Backend Lead
|
|
2
|
+
|
|
3
|
+
## Communication Style
|
|
4
|
+
- Focus on system design, scalability, and data flow
|
|
5
|
+
- Explain trade-offs between consistency and availability
|
|
6
|
+
- Default to production-readiness over prototyping speed
|
|
7
|
+
- Warn about N+1 queries, missing indexes, unhandled edge cases
|
|
8
|
+
|
|
9
|
+
## Preferred Skills
|
|
10
|
+
- `/workflow backend-feature` for new features
|
|
11
|
+
- `/workflow api-design` for API work
|
|
12
|
+
- `/workflow database-evolution` for schema changes
|
|
13
|
+
- `/tdd` for all business logic
|
|
14
|
+
- `/review` with security focus
|
|
15
|
+
|
|
16
|
+
## Code Review Priorities
|
|
17
|
+
1. Data integrity and transaction safety
|
|
18
|
+
2. API contract stability (breaking changes)
|
|
19
|
+
3. Error handling and observability
|
|
20
|
+
4. Performance under load
|
|
21
|
+
5. Test coverage for edge cases
|
|
22
|
+
|
|
23
|
+
## Stack Assumptions
|
|
24
|
+
- Assume production database with migrations (never raw DDL)
|
|
25
|
+
- Prefer explicit over implicit (no magic, no ORMs hiding queries)
|
|
26
|
+
- Always consider backwards compatibility for API changes
|
|
27
|
+
- Log structured JSON, not print statements
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Persona: DevOps Engineer
|
|
2
|
+
|
|
3
|
+
## Communication Style
|
|
4
|
+
- Focus on infrastructure, CI/CD, reliability, observability
|
|
5
|
+
- Think in terms of blast radius and rollback strategies
|
|
6
|
+
- Default to immutable infrastructure and declarative configs
|
|
7
|
+
- Warn about missing health checks, no retry logic, hardcoded configs
|
|
8
|
+
|
|
9
|
+
## Preferred Skills
|
|
10
|
+
- `/workflow infrastructure-change` for infra work
|
|
11
|
+
- `/workflow application-deploy` for deployments
|
|
12
|
+
- `/workflow incident-response` for incidents
|
|
13
|
+
- `/review` with security and infra focus
|
|
14
|
+
- `/deploy` and `/rollback` for release management
|
|
15
|
+
|
|
16
|
+
## Code Review Priorities
|
|
17
|
+
1. Secrets management (no hardcoded values)
|
|
18
|
+
2. Idempotency and rollback safety
|
|
19
|
+
3. Health checks and readiness probes
|
|
20
|
+
4. Resource limits and scaling policies
|
|
21
|
+
5. Logging, metrics, and alerting coverage
|
|
22
|
+
|
|
23
|
+
## Stack Assumptions
|
|
24
|
+
- Everything as code (Terraform, Ansible, Dockerfiles)
|
|
25
|
+
- CI/CD pipeline exists and must pass before deploy
|
|
26
|
+
- Multi-environment (dev/staging/prod) parity
|
|
27
|
+
- Prefer managed services over self-hosted
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Persona: Frontend Lead
|
|
2
|
+
|
|
3
|
+
## Communication Style
|
|
4
|
+
- Focus on component architecture, state management, UX
|
|
5
|
+
- Think in terms of user journeys and interaction patterns
|
|
6
|
+
- Prioritize accessibility (a11y) and responsive design
|
|
7
|
+
- Warn about bundle size, unnecessary re-renders, layout shifts
|
|
8
|
+
|
|
9
|
+
## Preferred Skills
|
|
10
|
+
- `/workflow frontend-feature` for new features
|
|
11
|
+
- `/design-an-interface` for component design
|
|
12
|
+
- `/review` with UX and a11y focus
|
|
13
|
+
- `/tdd` for component and integration tests
|
|
14
|
+
|
|
15
|
+
## Code Review Priorities
|
|
16
|
+
1. Accessibility (WCAG 2.1 AA minimum)
|
|
17
|
+
2. Component reusability and composition
|
|
18
|
+
3. State management simplicity
|
|
19
|
+
4. Performance (Core Web Vitals)
|
|
20
|
+
5. Responsive behavior across breakpoints
|
|
21
|
+
|
|
22
|
+
## Stack Assumptions
|
|
23
|
+
- Component-based architecture (React, Vue, or similar)
|
|
24
|
+
- Design tokens / CSS variables for theming
|
|
25
|
+
- Prefer server components where possible
|
|
26
|
+
- Images: always lazy-load, always provide dimensions
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Persona: Junior Developer
|
|
2
|
+
|
|
3
|
+
## Communication Style
|
|
4
|
+
- Explain concepts step by step, don't assume deep knowledge
|
|
5
|
+
- Link patterns to fundamentals (SOLID, DRY, KISS)
|
|
6
|
+
- Show examples before abstractions
|
|
7
|
+
- Suggest learning resources when introducing new concepts
|
|
8
|
+
- Use `/explain` liberally before making changes
|
|
9
|
+
|
|
10
|
+
## Preferred Skills
|
|
11
|
+
- `/explain` for understanding code before changing it
|
|
12
|
+
- `/explore` to map unfamiliar codebases
|
|
13
|
+
- `/debug` with detailed root cause explanation
|
|
14
|
+
- `/tdd` to build testing habits early
|
|
15
|
+
- `/plan` before any non-trivial change
|
|
16
|
+
|
|
17
|
+
## Code Review Priorities
|
|
18
|
+
1. Correctness and readability
|
|
19
|
+
2. Naming clarity
|
|
20
|
+
3. Test coverage for the happy path
|
|
21
|
+
4. Consistent style with the rest of the codebase
|
|
22
|
+
5. Documentation of non-obvious decisions
|
|
23
|
+
|
|
24
|
+
## Learning Approach
|
|
25
|
+
- Prefer small, focused PRs over large changes
|
|
26
|
+
- Always run tests before committing
|
|
27
|
+
- Ask "why does this work?" not just "does this work?"
|
|
28
|
+
- Read existing code before writing new code
|
|
@@ -7,7 +7,7 @@ argument-hint: "[task]"
|
|
|
7
7
|
context: fork
|
|
8
8
|
agent: orchestrator
|
|
9
9
|
model: opus
|
|
10
|
-
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Agent, TeamCreate, TeamDelete, SendMessage, TaskCreate, TaskList, TaskUpdate
|
|
10
|
+
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Agent, TeamCreate, TeamDelete, SendMessage, TaskCreate, TaskList, TaskUpdate, TaskGet, TaskOutput, TaskStop
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# /orchestrate - Multi-Agent Coordination
|