marketing_mario 1.0.0 → 1.0.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.
- checksums.yaml +4 -4
- data/data/agents/mario-ads-executor.md +5 -5
- data/data/agents/mario-backlog-planner.md +8 -8
- data/data/agents/mario-debugger.md +13 -13
- data/data/agents/mario-email-executor.md +5 -5
- data/data/agents/mario-executor.md +4 -4
- data/data/agents/mario-planner.md +8 -8
- data/data/agents/mario-project-researcher.md +6 -6
- data/data/agents/mario-research-synthesizer.md +13 -13
- data/data/agents/mario-seo-executor.md +5 -5
- data/data/agents/mario-social-executor.md +5 -5
- data/data/agents/mario-strategy-executor.md +7 -7
- data/data/agents/mario-topic-researcher.md +2 -2
- data/data/agents/mario-web-executor.md +5 -5
- data/data/commands/mario/add-todo.md +1 -1
- data/data/commands/mario/check-todos.md +2 -2
- data/data/commands/mario/create.md +4 -4
- data/data/commands/mario/debug.md +3 -3
- data/data/commands/mario/execute.md +2 -2
- data/data/commands/mario/new-from-template.md +3 -3
- data/data/commands/mario/new-project.md +10 -10
- data/data/commands/mario/plan.md +2 -2
- data/data/commands/mario/progress.md +2 -2
- data/data/commands/mario/quick.md +3 -3
- data/data/commands/mario/save-template.md +1 -1
- data/data/mario/references/decimal-phase-calculation.md +8 -8
- data/data/mario/references/git-integration.md +4 -4
- data/data/mario/references/git-planning-commit.md +7 -7
- data/data/mario/references/model-profile-resolution.md +1 -1
- data/data/mario/references/model-profiles.md +2 -2
- data/data/mario/references/planning-config.md +13 -13
- data/data/mario/references/tdd.md +2 -2
- data/data/mario/templates/DEBUG.md +2 -2
- data/data/mario/templates/backlog.md +1 -1
- data/data/mario/templates/codebase/audience-insights.md +1 -1
- data/data/mario/templates/codebase/brand-guidelines.md +1 -1
- data/data/mario/templates/codebase/channel-architecture.md +1 -1
- data/data/mario/templates/codebase/content-inventory.md +1 -1
- data/data/mario/templates/codebase/marketing-gaps.md +1 -1
- data/data/mario/templates/codebase/performance-metrics.md +1 -1
- data/data/mario/templates/codebase/tools-and-platforms.md +1 -1
- data/data/mario/templates/debug-subagent-prompt.md +2 -2
- data/data/mario/templates/foundations/AUDIENCE-PERSONAS.md +1 -1
- data/data/mario/templates/foundations/BRAND-BIBLE.md +3 -3
- data/data/mario/templates/foundations/BRAND-IDENTITY.md +1 -1
- data/data/mario/templates/foundations/CHANNELS-DISTRIBUTION.md +1 -1
- data/data/mario/templates/foundations/COMPETITIVE-LANDSCAPE.md +1 -1
- data/data/mario/templates/foundations/MESSAGING-FRAMEWORK.md +1 -1
- data/data/mario/templates/foundations/PRODUCT-SERVICE.md +1 -1
- data/data/mario/templates/foundations/VOICE-TONE.md +1 -1
- data/data/mario/templates/plan-prompt.md +17 -17
- data/data/mario/templates/planner-subagent-prompt.md +6 -6
- data/data/mario/templates/project.md +2 -2
- data/data/mario/templates/requirements.md +1 -1
- data/data/mario/templates/research.md +2 -2
- data/data/mario/templates/state.md +4 -4
- data/data/mario/templates/summary.md +1 -1
- data/data/mario/templates/user-setup.md +2 -2
- data/data/mario/workflows/add-todo.md +7 -7
- data/data/mario/workflows/check-todos.md +4 -4
- data/data/mario/workflows/create.md +6 -6
- data/data/mario/workflows/diagnose-issues.md +4 -4
- data/data/mario/workflows/execute-plan.md +13 -13
- data/data/mario/workflows/execute.md +4 -4
- data/data/mario/workflows/help.md +5 -5
- data/data/mario/workflows/new-from-template.md +3 -3
- data/data/mario/workflows/new-project.md +38 -38
- data/data/mario/workflows/plan.md +4 -4
- data/data/mario/workflows/progress.md +3 -3
- data/data/mario/workflows/quick.md +5 -5
- data/data/mario/workflows/settings.md +5 -5
- data/data/templates.md +1 -1
- data/lib/marketing_mario/tools/backlog_manager.rb +5 -5
- data/lib/marketing_mario/tools/config_manager.rb +5 -5
- data/lib/marketing_mario/tools/git_integration.rb +2 -2
- data/lib/marketing_mario/tools/init.rb +42 -42
- data/lib/marketing_mario/tools/plan_manager.rb +6 -6
- data/lib/marketing_mario/tools/state_manager.rb +10 -10
- data/lib/marketing_mario/tools/template_filler.rb +3 -3
- data/lib/marketing_mario/tools/template_manager.rb +1 -1
- data/lib/marketing_mario/tools/utilities.rb +4 -4
- data/lib/marketing_mario/tools/verification.rb +4 -4
- data/lib/marketing_mario/version.rb +1 -1
- data/lib/marketing_mario.rb +2 -0
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: c10a76b6d702f7ede0db34ec8f4d12de3fe945323e7e3eae7fe250ab5d0b49b3
|
|
4
|
+
data.tar.gz: fe5f1d1fbcf8d3d68d72867ad2b5fb7065b04db3d66351984363d837ae5575c0
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5d27e57a471439d35f91f6413987359385eb3ab642d34f38f52f194268c4ae99131f0b3e49eed455890039f6e4567499dcb486b5400f561c431459582da1b208
|
|
7
|
+
data.tar.gz: dbdd2f62c8f53acbb22f90a58845c913e6c189e832abd4192278bc75ee5477fe1a0247d3bbdcf86702400a57a3450df4de9051244e9664552a279bf27430d58e
|
|
@@ -48,11 +48,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
48
48
|
|
|
49
49
|
Also read STATE.md for position, decisions, blockers:
|
|
50
50
|
```bash
|
|
51
|
-
cat .
|
|
51
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
If STATE.md missing but .
|
|
55
|
-
If .
|
|
54
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
55
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
56
56
|
</step>
|
|
57
57
|
|
|
58
58
|
<step name="load_plan">
|
|
@@ -168,7 +168,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
168
168
|
</task_commit_protocol>
|
|
169
169
|
|
|
170
170
|
<summary_creation>
|
|
171
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
171
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
172
172
|
|
|
173
173
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
174
174
|
|
|
@@ -204,7 +204,7 @@ mario-tools state update \
|
|
|
204
204
|
|
|
205
205
|
<final_commit>
|
|
206
206
|
```bash
|
|
207
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
207
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
208
208
|
```
|
|
209
209
|
</final_commit>
|
|
210
210
|
|
|
@@ -440,11 +440,11 @@ When files are written and returning to orchestrator:
|
|
|
440
440
|
## BACKLOG CREATED
|
|
441
441
|
|
|
442
442
|
**Files written:**
|
|
443
|
-
- .
|
|
444
|
-
- .
|
|
443
|
+
- .mario_planning/BACKLOG.md
|
|
444
|
+
- .mario_planning/STATE.md
|
|
445
445
|
|
|
446
446
|
**Updated:**
|
|
447
|
-
- .
|
|
447
|
+
- .mario_planning/REQUIREMENTS.md (traceability section)
|
|
448
448
|
|
|
449
449
|
### Summary
|
|
450
450
|
|
|
@@ -470,8 +470,8 @@ When files are written and returning to orchestrator:
|
|
|
470
470
|
### Files Ready for Review
|
|
471
471
|
|
|
472
472
|
User can review actual files:
|
|
473
|
-
- `cat .
|
|
474
|
-
- `cat .
|
|
473
|
+
- `cat .mario_planning/BACKLOG.md`
|
|
474
|
+
- `cat .mario_planning/STATE.md`
|
|
475
475
|
|
|
476
476
|
{If gaps found during creation:}
|
|
477
477
|
|
|
@@ -494,9 +494,9 @@ After incorporating user feedback and updating files:
|
|
|
494
494
|
- {change 2}
|
|
495
495
|
|
|
496
496
|
**Files updated:**
|
|
497
|
-
- .
|
|
498
|
-
- .
|
|
499
|
-
- .
|
|
497
|
+
- .mario_planning/BACKLOG.md
|
|
498
|
+
- .mario_planning/STATE.md (if needed)
|
|
499
|
+
- .mario_planning/REQUIREMENTS.md (if traceability changed)
|
|
500
500
|
|
|
501
501
|
### Updated Summary
|
|
502
502
|
|
|
@@ -718,8 +718,8 @@ Can I observe the behavior directly?
|
|
|
718
718
|
## File Location
|
|
719
719
|
|
|
720
720
|
```
|
|
721
|
-
DEBUG_DIR=.
|
|
722
|
-
DEBUG_RESOLVED_DIR=.
|
|
721
|
+
DEBUG_DIR=.mario_planning/debug
|
|
722
|
+
DEBUG_RESOLVED_DIR=.mario_planning/debug/resolved
|
|
723
723
|
```
|
|
724
724
|
|
|
725
725
|
## File Structure
|
|
@@ -815,7 +815,7 @@ The file IS the debugging brain.
|
|
|
815
815
|
**First:** Check for active debug sessions.
|
|
816
816
|
|
|
817
817
|
```bash
|
|
818
|
-
ls .
|
|
818
|
+
ls .mario_planning/debug/*.md 2>/dev/null | grep -v resolved
|
|
819
819
|
```
|
|
820
820
|
|
|
821
821
|
**If active sessions exist AND no $ARGUMENTS:**
|
|
@@ -836,7 +836,7 @@ ls .planning/debug/*.md 2>/dev/null | grep -v resolved
|
|
|
836
836
|
**Create debug file IMMEDIATELY.**
|
|
837
837
|
|
|
838
838
|
1. Generate slug from user input (lowercase, hyphens, max 30 chars)
|
|
839
|
-
2. `mkdir -p .
|
|
839
|
+
2. `mkdir -p .mario_planning/debug`
|
|
840
840
|
3. Create file with initial state:
|
|
841
841
|
- status: gathering
|
|
842
842
|
- trigger: verbatim $ARGUMENTS
|
|
@@ -908,7 +908,7 @@ Return structured diagnosis:
|
|
|
908
908
|
```markdown
|
|
909
909
|
## ROOT CAUSE FOUND
|
|
910
910
|
|
|
911
|
-
**Debug Session:** .
|
|
911
|
+
**Debug Session:** .mario_planning/debug/{slug}.md
|
|
912
912
|
|
|
913
913
|
**Root Cause:** {from Resolution.root_cause}
|
|
914
914
|
|
|
@@ -927,7 +927,7 @@ If inconclusive:
|
|
|
927
927
|
```markdown
|
|
928
928
|
## INVESTIGATION INCONCLUSIVE
|
|
929
929
|
|
|
930
|
-
**Debug Session:** .
|
|
930
|
+
**Debug Session:** .mario_planning/debug/{slug}.md
|
|
931
931
|
|
|
932
932
|
**What Was Checked:**
|
|
933
933
|
- {area}: {finding}
|
|
@@ -964,8 +964,8 @@ Update status to "fixing".
|
|
|
964
964
|
Update status to "resolved".
|
|
965
965
|
|
|
966
966
|
```bash
|
|
967
|
-
mkdir -p .
|
|
968
|
-
mv .
|
|
967
|
+
mkdir -p .mario_planning/debug/resolved
|
|
968
|
+
mv .mario_planning/debug/{slug}.md .mario_planning/debug/resolved/
|
|
969
969
|
```
|
|
970
970
|
|
|
971
971
|
**Check planning config using state load (commit_docs is available from the output):**
|
|
@@ -988,7 +988,7 @@ Root cause: {root_cause}"
|
|
|
988
988
|
|
|
989
989
|
Then commit planning docs via CLI (respects `commit_docs` config automatically):
|
|
990
990
|
```bash
|
|
991
|
-
mario-tools commit "docs: resolve debug {slug}" --files .
|
|
991
|
+
mario-tools commit "docs: resolve debug {slug}" --files .mario_planning/debug/resolved/{slug}.md
|
|
992
992
|
```
|
|
993
993
|
|
|
994
994
|
Report completion and offer next steps.
|
|
@@ -1011,7 +1011,7 @@ Return a checkpoint when:
|
|
|
1011
1011
|
## CHECKPOINT REACHED
|
|
1012
1012
|
|
|
1013
1013
|
**Type:** [human-verify | human-action | decision]
|
|
1014
|
-
**Debug Session:** .
|
|
1014
|
+
**Debug Session:** .mario_planning/debug/{slug}.md
|
|
1015
1015
|
**Progress:** {evidence_count} evidence entries, {eliminated_count} hypotheses eliminated
|
|
1016
1016
|
|
|
1017
1017
|
### Investigation State
|
|
@@ -1082,7 +1082,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1082
1082
|
```markdown
|
|
1083
1083
|
## ROOT CAUSE FOUND
|
|
1084
1084
|
|
|
1085
|
-
**Debug Session:** .
|
|
1085
|
+
**Debug Session:** .mario_planning/debug/{slug}.md
|
|
1086
1086
|
|
|
1087
1087
|
**Root Cause:** {specific cause with evidence}
|
|
1088
1088
|
|
|
@@ -1103,7 +1103,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1103
1103
|
```markdown
|
|
1104
1104
|
## DEBUG COMPLETE
|
|
1105
1105
|
|
|
1106
|
-
**Debug Session:** .
|
|
1106
|
+
**Debug Session:** .mario_planning/debug/resolved/{slug}.md
|
|
1107
1107
|
|
|
1108
1108
|
**Root Cause:** {what was wrong}
|
|
1109
1109
|
**Fix Applied:** {what was changed}
|
|
@@ -1121,7 +1121,7 @@ Orchestrator presents checkpoint to user, gets response, spawns fresh continuati
|
|
|
1121
1121
|
```markdown
|
|
1122
1122
|
## INVESTIGATION INCONCLUSIVE
|
|
1123
1123
|
|
|
1124
|
-
**Debug Session:** .
|
|
1124
|
+
**Debug Session:** .mario_planning/debug/{slug}.md
|
|
1125
1125
|
|
|
1126
1126
|
**What Was Checked:**
|
|
1127
1127
|
- {area 1}: {finding}
|
|
@@ -48,11 +48,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
48
48
|
|
|
49
49
|
Also read STATE.md for position, decisions, blockers:
|
|
50
50
|
```bash
|
|
51
|
-
cat .
|
|
51
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
If STATE.md missing but .
|
|
55
|
-
If .
|
|
54
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
55
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
56
56
|
</step>
|
|
57
57
|
|
|
58
58
|
<step name="load_plan">
|
|
@@ -168,7 +168,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
168
168
|
</task_commit_protocol>
|
|
169
169
|
|
|
170
170
|
<summary_creation>
|
|
171
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
171
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
172
172
|
|
|
173
173
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
174
174
|
|
|
@@ -204,7 +204,7 @@ mario-tools state update \
|
|
|
204
204
|
|
|
205
205
|
<final_commit>
|
|
206
206
|
```bash
|
|
207
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
207
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
208
208
|
```
|
|
209
209
|
</final_commit>
|
|
210
210
|
|
|
@@ -26,11 +26,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_file`
|
|
|
26
26
|
|
|
27
27
|
Also read STATE.md for position, decisions, blockers:
|
|
28
28
|
```bash
|
|
29
|
-
cat .
|
|
29
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
If STATE.md missing but .
|
|
33
|
-
If .
|
|
32
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
33
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
34
34
|
</step>
|
|
35
35
|
|
|
36
36
|
<step name="load_plan">
|
|
@@ -347,7 +347,7 @@ mario-tools state add-blocker "Blocker description"
|
|
|
347
347
|
|
|
348
348
|
<final_commit>
|
|
349
349
|
```bash
|
|
350
|
-
mario-tools commit "docs(${PLAN}): complete plan" --files "${PLAN_DIR}/SUMMARY.md" .
|
|
350
|
+
mario-tools commit "docs(${PLAN}): complete plan" --files "${PLAN_DIR}/SUMMARY.md" .mario_planning/STATE.md
|
|
351
351
|
```
|
|
352
352
|
|
|
353
353
|
Separate from per-task commits — captures execution results only.
|
|
@@ -250,9 +250,9 @@ Output: [Artifacts created]
|
|
|
250
250
|
</execution_context>
|
|
251
251
|
|
|
252
252
|
<context>
|
|
253
|
-
@.
|
|
254
|
-
@.
|
|
255
|
-
@.
|
|
253
|
+
@.mario_planning/PROJECT.md
|
|
254
|
+
@.mario_planning/BACKLOG.md
|
|
255
|
+
@.mario_planning/STATE.md
|
|
256
256
|
|
|
257
257
|
@path/to/relevant/source.md
|
|
258
258
|
</context>
|
|
@@ -534,17 +534,17 @@ Extract from init JSON: `planner_model`, `researcher_model`, `commit_docs`, `res
|
|
|
534
534
|
|
|
535
535
|
Also read STATE.md for position, decisions, blockers:
|
|
536
536
|
```bash
|
|
537
|
-
cat .
|
|
537
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
538
538
|
```
|
|
539
539
|
|
|
540
|
-
If STATE.md missing but .
|
|
540
|
+
If STATE.md missing but .mario_planning/ exists, offer to reconstruct or continue without.
|
|
541
541
|
</step>
|
|
542
542
|
|
|
543
543
|
<step name="load_codebase_context">
|
|
544
544
|
Check for codebase map:
|
|
545
545
|
|
|
546
546
|
```bash
|
|
547
|
-
ls .
|
|
547
|
+
ls .mario_planning/codebase/*.md 2>/dev/null
|
|
548
548
|
```
|
|
549
549
|
|
|
550
550
|
If exists, load relevant documents by plan type:
|
|
@@ -563,8 +563,8 @@ If exists, load relevant documents by plan type:
|
|
|
563
563
|
|
|
564
564
|
<step name="identify_plan">
|
|
565
565
|
```bash
|
|
566
|
-
cat .
|
|
567
|
-
ls .
|
|
566
|
+
cat .mario_planning/BACKLOG.md
|
|
567
|
+
ls .mario_planning/plans/
|
|
568
568
|
```
|
|
569
569
|
|
|
570
570
|
Read the plan topic from BACKLOG.md. Read existing RESEARCH.md or DISCOVERY.md in plan directory if present.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mario-project-researcher
|
|
3
|
-
description: Researches brand foundations for permanent reference. Produces files in .
|
|
3
|
+
description: Researches brand foundations for permanent reference. Produces files in .mario_planning/foundations/ loaded by every content session. Spawned by /mario:new-project orchestrator.
|
|
4
4
|
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
|
|
5
5
|
color: cyan
|
|
6
6
|
---
|
|
@@ -8,7 +8,7 @@ color: cyan
|
|
|
8
8
|
<role>
|
|
9
9
|
You are an expert brand researcher spawned by `/mario:new-project`.
|
|
10
10
|
|
|
11
|
-
Answer "What are this brand's foundations?" Write research files in `.
|
|
11
|
+
Answer "What are this brand's foundations?" Write research files in `.mario_planning/foundations/` that serve as permanent brand reference for all content creation.
|
|
12
12
|
|
|
13
13
|
Your files are permanent brand reference documents loaded by every content session:
|
|
14
14
|
|
|
@@ -179,7 +179,7 @@ Never present LOW confidence findings as authoritative.
|
|
|
179
179
|
|
|
180
180
|
<output_formats>
|
|
181
181
|
|
|
182
|
-
All files → `.
|
|
182
|
+
All files → `.mario_planning/foundations/`
|
|
183
183
|
|
|
184
184
|
Each spawn writes ONE foundation file. The workflow tells you which dimension to research. Use the template provided by the workflow for your assigned dimension.
|
|
185
185
|
|
|
@@ -231,7 +231,7 @@ Run pre-submission checklist (see verification_protocol).
|
|
|
231
231
|
|
|
232
232
|
## Step 5: Write Foundation File
|
|
233
233
|
|
|
234
|
-
In `.
|
|
234
|
+
In `.mario_planning/foundations/`:
|
|
235
235
|
Write the single foundation file for your assigned dimension, following the template provided by the workflow.
|
|
236
236
|
|
|
237
237
|
## Step 6: Return Structured Result
|
|
@@ -259,7 +259,7 @@ Write the single foundation file for your assigned dimension, following the temp
|
|
|
259
259
|
|
|
260
260
|
| File | Purpose |
|
|
261
261
|
|------|---------|
|
|
262
|
-
| .
|
|
262
|
+
| .mario_planning/foundations/{DIMENSION}.md | {description} |
|
|
263
263
|
|
|
264
264
|
### Confidence Assessment
|
|
265
265
|
|
|
@@ -308,7 +308,7 @@ Research is complete when:
|
|
|
308
308
|
- [ ] Findings are comprehensive and opinionated
|
|
309
309
|
- [ ] Source hierarchy followed (Official Docs → WebSearch verified → WebSearch unverified)
|
|
310
310
|
- [ ] All findings have confidence levels
|
|
311
|
-
- [ ] Output file created in `.
|
|
311
|
+
- [ ] Output file created in `.mario_planning/foundations/`
|
|
312
312
|
- [ ] File follows template format
|
|
313
313
|
- [ ] Files written (DO NOT commit — orchestrator handles this)
|
|
314
314
|
- [ ] Structured return provided to orchestrator
|
|
@@ -15,7 +15,7 @@ You are spawned by:
|
|
|
15
15
|
Your job: Create a unified brand bible that serves as the authoritative reference for all content creation. Extract key findings, identify patterns across foundation files, and produce a quick-reference document that every content session loads.
|
|
16
16
|
|
|
17
17
|
**Core responsibilities:**
|
|
18
|
-
- Read all 7 foundation files from `.
|
|
18
|
+
- Read all 7 foundation files from `.mario_planning/foundations/`
|
|
19
19
|
- Synthesize findings into executive summary and quick-reference sections
|
|
20
20
|
- Derive content creation guidelines from combined research
|
|
21
21
|
- Identify confidence levels and gaps
|
|
@@ -42,7 +42,7 @@ Your BRAND-BIBLE.md is loaded by every `/mario:create` content session as primar
|
|
|
42
42
|
|
|
43
43
|
## Step 1: Read Foundation Files
|
|
44
44
|
|
|
45
|
-
Read all 7 foundation files from `.
|
|
45
|
+
Read all 7 foundation files from `.mario_planning/foundations/`:
|
|
46
46
|
|
|
47
47
|
```
|
|
48
48
|
BRAND-IDENTITY.md
|
|
@@ -131,14 +131,14 @@ Identify gaps that couldn't be resolved and need attention during content creati
|
|
|
131
131
|
|
|
132
132
|
Use template: `~/.claude/mario/templates/foundations/BRAND-BIBLE.md`
|
|
133
133
|
|
|
134
|
-
Write to `.
|
|
134
|
+
Write to `.mario_planning/foundations/BRAND-BIBLE.md`
|
|
135
135
|
|
|
136
136
|
## Step 10: Commit All Foundation Files
|
|
137
137
|
|
|
138
138
|
The 7 parallel researcher agents write files but do NOT commit. You commit everything together.
|
|
139
139
|
|
|
140
140
|
```bash
|
|
141
|
-
mario-tools commit "docs: complete brand foundations research" --files .
|
|
141
|
+
mario-tools commit "docs: complete brand foundations research" --files .mario_planning/foundations/
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
## Step 11: Return Summary
|
|
@@ -173,15 +173,15 @@ When BRAND-BIBLE.md is written and committed:
|
|
|
173
173
|
## SYNTHESIS COMPLETE
|
|
174
174
|
|
|
175
175
|
**Files synthesized:**
|
|
176
|
-
- .
|
|
177
|
-
- .
|
|
178
|
-
- .
|
|
179
|
-
- .
|
|
180
|
-
- .
|
|
181
|
-
- .
|
|
182
|
-
- .
|
|
183
|
-
|
|
184
|
-
**Output:** .
|
|
176
|
+
- .mario_planning/foundations/BRAND-IDENTITY.md
|
|
177
|
+
- .mario_planning/foundations/VOICE-TONE.md
|
|
178
|
+
- .mario_planning/foundations/AUDIENCE-PERSONAS.md
|
|
179
|
+
- .mario_planning/foundations/COMPETITIVE-LANDSCAPE.md
|
|
180
|
+
- .mario_planning/foundations/MESSAGING-FRAMEWORK.md
|
|
181
|
+
- .mario_planning/foundations/PRODUCT-SERVICE.md
|
|
182
|
+
- .mario_planning/foundations/CHANNELS-DISTRIBUTION.md
|
|
183
|
+
|
|
184
|
+
**Output:** .mario_planning/foundations/BRAND-BIBLE.md
|
|
185
185
|
|
|
186
186
|
### Executive Summary
|
|
187
187
|
|
|
@@ -48,11 +48,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
48
48
|
|
|
49
49
|
Also read STATE.md for position, decisions, blockers:
|
|
50
50
|
```bash
|
|
51
|
-
cat .
|
|
51
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
If STATE.md missing but .
|
|
55
|
-
If .
|
|
54
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
55
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
56
56
|
</step>
|
|
57
57
|
|
|
58
58
|
<step name="load_plan">
|
|
@@ -168,7 +168,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
168
168
|
</task_commit_protocol>
|
|
169
169
|
|
|
170
170
|
<summary_creation>
|
|
171
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
171
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
172
172
|
|
|
173
173
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
174
174
|
|
|
@@ -204,7 +204,7 @@ mario-tools state update \
|
|
|
204
204
|
|
|
205
205
|
<final_commit>
|
|
206
206
|
```bash
|
|
207
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
207
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
208
208
|
```
|
|
209
209
|
</final_commit>
|
|
210
210
|
|
|
@@ -48,11 +48,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
48
48
|
|
|
49
49
|
Also read STATE.md for position, decisions, blockers:
|
|
50
50
|
```bash
|
|
51
|
-
cat .
|
|
51
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
If STATE.md missing but .
|
|
55
|
-
If .
|
|
54
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
55
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
56
56
|
</step>
|
|
57
57
|
|
|
58
58
|
<step name="load_plan">
|
|
@@ -168,7 +168,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
168
168
|
</task_commit_protocol>
|
|
169
169
|
|
|
170
170
|
<summary_creation>
|
|
171
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
171
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
172
172
|
|
|
173
173
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
174
174
|
|
|
@@ -204,7 +204,7 @@ mario-tools state update \
|
|
|
204
204
|
|
|
205
205
|
<final_commit>
|
|
206
206
|
```bash
|
|
207
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
207
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
208
208
|
```
|
|
209
209
|
</final_commit>
|
|
210
210
|
|
|
@@ -47,11 +47,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
47
47
|
|
|
48
48
|
Also read STATE.md for position, decisions, blockers:
|
|
49
49
|
```bash
|
|
50
|
-
cat .
|
|
50
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
If STATE.md missing but .
|
|
54
|
-
If .
|
|
53
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
54
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
55
55
|
</step>
|
|
56
56
|
|
|
57
57
|
<step name="load_plan">
|
|
@@ -150,8 +150,8 @@ After each task completes (verification passed, done criteria met), commit immed
|
|
|
150
150
|
|
|
151
151
|
**2. Stage task-related files individually** (NEVER `git add .` or `git add -A`):
|
|
152
152
|
```bash
|
|
153
|
-
git add .
|
|
154
|
-
git add .
|
|
153
|
+
git add .mario_planning/strategy/personas.md
|
|
154
|
+
git add .mario_planning/strategy/brand-voice.md
|
|
155
155
|
```
|
|
156
156
|
|
|
157
157
|
**3. Commit:**
|
|
@@ -167,7 +167,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
167
167
|
</task_commit_protocol>
|
|
168
168
|
|
|
169
169
|
<summary_creation>
|
|
170
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
170
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
171
171
|
|
|
172
172
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
173
173
|
|
|
@@ -203,7 +203,7 @@ mario-tools state update \
|
|
|
203
203
|
|
|
204
204
|
<final_commit>
|
|
205
205
|
```bash
|
|
206
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
206
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
207
207
|
```
|
|
208
208
|
</final_commit>
|
|
209
209
|
|
|
@@ -18,7 +18,7 @@ Answer "What already exists on this topic and how can we do better?" Analyze com
|
|
|
18
18
|
- Produce a structured research brief with gap analysis, recommended angle, and proposed outline
|
|
19
19
|
- Return structured result to orchestrator
|
|
20
20
|
|
|
21
|
-
**This is NOT brand research.** Brand foundations already exist in `.
|
|
21
|
+
**This is NOT brand research.** Brand foundations already exist in `.mario_planning/foundations/`. Your job is topic-specific competitive content analysis.
|
|
22
22
|
|
|
23
23
|
**Content-type-aware:** Your research strategy adapts based on what's being created. Researching a blog post is fundamentally different from researching a landing page or a newsletter.
|
|
24
24
|
</role>
|
|
@@ -72,7 +72,7 @@ Fetch the top 3-5 most relevant/authoritative results. For each, extract:
|
|
|
72
72
|
- **Audience:** Who are they writing for?
|
|
73
73
|
|
|
74
74
|
### 3. Read — Load Brand Context
|
|
75
|
-
Read `.
|
|
75
|
+
Read `.mario_planning/foundations/BRAND-BIBLE.md` to understand:
|
|
76
76
|
- Brand voice (to inform angle recommendation)
|
|
77
77
|
- Target personas (to identify audience-specific gaps)
|
|
78
78
|
- Competitive positioning (to find differentiation angles)
|
|
@@ -56,11 +56,11 @@ Extract from init JSON: `executor_model`, `commit_docs`, `plan_dir`, `plan_numbe
|
|
|
56
56
|
|
|
57
57
|
Also read STATE.md for position, decisions, blockers:
|
|
58
58
|
```bash
|
|
59
|
-
cat .
|
|
59
|
+
cat .mario_planning/STATE.md 2>/dev/null
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
If STATE.md missing but .
|
|
63
|
-
If .
|
|
62
|
+
If STATE.md missing but .mario_planning/ exists: offer to reconstruct or continue without.
|
|
63
|
+
If .mario_planning/ missing: Error — project not initialized.
|
|
64
64
|
</step>
|
|
65
65
|
|
|
66
66
|
<step name="load_plan">
|
|
@@ -176,7 +176,7 @@ git commit -m "{type}(plan-{NNN}): {concise task description}
|
|
|
176
176
|
</task_commit_protocol>
|
|
177
177
|
|
|
178
178
|
<summary_creation>
|
|
179
|
-
After all tasks complete, create `SUMMARY.md` at `.
|
|
179
|
+
After all tasks complete, create `SUMMARY.md` at `.mario_planning/plans/NNN-slug/`.
|
|
180
180
|
|
|
181
181
|
**Use template:** @~/.claude/mario/templates/summary.md
|
|
182
182
|
|
|
@@ -212,7 +212,7 @@ mario-tools state update \
|
|
|
212
212
|
|
|
213
213
|
<final_commit>
|
|
214
214
|
```bash
|
|
215
|
-
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .
|
|
215
|
+
mario-tools commit "docs(plan-{NNN}): complete [plan-name] plan" --files .mario_planning/plans/NNN-slug/SUMMARY.md .mario_planning/STATE.md
|
|
216
216
|
```
|
|
217
217
|
</final_commit>
|
|
218
218
|
|
|
@@ -21,8 +21,8 @@ Routes to the check-todos workflow which handles:
|
|
|
21
21
|
</objective>
|
|
22
22
|
|
|
23
23
|
<execution_context>
|
|
24
|
-
@.
|
|
25
|
-
@.
|
|
24
|
+
@.mario_planning/STATE.md
|
|
25
|
+
@.mario_planning/BACKLOG.md
|
|
26
26
|
@~/.claude/mario/workflows/check-todos.md
|
|
27
27
|
</execution_context>
|
|
28
28
|
|
|
@@ -27,8 +27,8 @@ Example usage:
|
|
|
27
27
|
Create on-demand content backed by brand foundations and topic research.
|
|
28
28
|
|
|
29
29
|
**Loads:**
|
|
30
|
-
- `.
|
|
31
|
-
- `.
|
|
30
|
+
- `.mario_planning/foundations/BRAND-BIBLE.md` — brand voice, personas, messages, positioning
|
|
31
|
+
- `.mario_planning/PROJECT.md` — project context
|
|
32
32
|
|
|
33
33
|
**Flow:** Research topic → Checkpoint (approve angle) → Generate → Iterate → Finalize
|
|
34
34
|
|
|
@@ -38,8 +38,8 @@ Create on-demand content backed by brand foundations and topic research.
|
|
|
38
38
|
<execution_context>
|
|
39
39
|
@~/.claude/mario/workflows/create.md
|
|
40
40
|
@~/.claude/mario/references/ui-brand.md
|
|
41
|
-
@.
|
|
42
|
-
@.
|
|
41
|
+
@.mario_planning/foundations/BRAND-BIBLE.md
|
|
42
|
+
@.mario_planning/PROJECT.md
|
|
43
43
|
</execution_context>
|
|
44
44
|
|
|
45
45
|
<process>
|
|
@@ -22,7 +22,7 @@ User's issue: $ARGUMENTS
|
|
|
22
22
|
|
|
23
23
|
Check for active sessions:
|
|
24
24
|
```bash
|
|
25
|
-
ls .
|
|
25
|
+
ls .mario_planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
|
|
26
26
|
```
|
|
27
27
|
</context>
|
|
28
28
|
|
|
@@ -85,7 +85,7 @@ goal: find_and_fix
|
|
|
85
85
|
</mode>
|
|
86
86
|
|
|
87
87
|
<debug_file>
|
|
88
|
-
Create: .
|
|
88
|
+
Create: .mario_planning/debug/{slug}.md
|
|
89
89
|
</debug_file>
|
|
90
90
|
```
|
|
91
91
|
|
|
@@ -129,7 +129,7 @@ Continue debugging {slug}. Evidence is in the debug file.
|
|
|
129
129
|
</objective>
|
|
130
130
|
|
|
131
131
|
<prior_state>
|
|
132
|
-
Debug file: @.
|
|
132
|
+
Debug file: @.mario_planning/debug/{slug}.md
|
|
133
133
|
</prior_state>
|
|
134
134
|
|
|
135
135
|
<checkpoint_response>
|