Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@
},
"metadata": {
"description": "AI-powered strategic advisor for entrepreneurs. 158 skills, 24 diagnostics, 21 playbooks, 9 industry packs.",
"version": "1.1.0"
"version": "1.1.1"
},
"plugins": [
{
"name": "foreman",
"description": "AI-powered strategic advisor for entrepreneurs. 158 business framework skills, 24 diagnostic triage systems, 21 multi-step playbooks, 48 output templates, 9 industry packs, board simulation, implementation tracking, research guides, and organizational politics navigation. Supports solo mode, Stoic philosophical mode, and multilingual output.",
"version": "1.1.0",
"version": "1.1.1",
"author": {
"name": "Fatih Guner"
},
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "foreman",
"version": "1.1.0",
"version": "1.1.1",
"description": "AI-powered strategic advisor for entrepreneurs",
"author": {
"name": "Fatih Guner"
Expand Down
6 changes: 3 additions & 3 deletions .claude/RUNTIME.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Use exact catalog identifiers first, then `aliases`, then a unique normalized na

## Persistence

All hosts use schema version 1 at `<workspace>/.foreman/<founder-id>/state.json`. Keep this file private and outside version control. The default founder ID for the local CLI is `default`. For multiple founders, pass an explicit ID on every call; never infer another founder's records. OpenClaw scopes data by its trusted agent and sender context. To share an existing agent-only store with the CLI, pass that agent ID as `--founder`.
All hosts use schema version 1 at `<workspace>/.foreman/<founder-id>/state.json`. Keep this file private; the runtime writes `.foreman/.gitignore` so the store stays outside version control. The default founder ID for the local CLI is `default`. For multiple founders, pass an explicit ID on every call; never infer another founder's records. OpenClaw scopes data by its trusted agent and sender context. To share an existing agent-only store with the CLI, pass that agent ID as `--founder`.

Run `node "<content-root>/runtime/run.mjs" <command> --workspace "<project-root>" --founder default ...`. Substitute real absolute paths and shell-quote each argument. User text is data; never interpolate it as executable shell syntax. This runtime needs Node 22.19 or later, and no package install or network connection. Check its exit status and returned JSON. Do not edit `state.json` directly.

Expand All @@ -20,7 +20,7 @@ Honor the scope requested by the user. A mode or language requested only for thi

Read tasks: `track --filter all` (also `active`, `overdue`, `stalled`, or any of the six statuses). Add a confirmed task: `task --id impl-001 --description "Interview five customers" --deadline 2026-10-01`. Update `/progress impl-001 40 note`: `task --id impl-001 --progress 40 --note "note"`. Status changes use `--status not-started|in-progress|blocked|completed|abandoned|deferred`. A completed task has progress 100. Use `--revision N` when editing a previously read revision; a conflict requires rereading, not overwriting.

After a confirmed playbook step, save the next step: `resume --playbook pivot-playbook --step 2`. Read `resume` to continue from that checkpoint; verify the playbook and step against the catalog before writing. The exposed Claude command is `/foreman-resume`, because `/resume` is a host command. Never mark a step complete based merely on a generated recommendation.
After a confirmed playbook step, save the next step: `resume --playbook pivot-playbook --step 2`. Read `resume` to continue from that checkpoint. The runtime rejects a playbook that is not in the catalog and a step beyond the playbook's length; confirm the step with the user before writing. The exposed Claude command is `/foreman-resume`, because `/resume` is a host command. Never mark a step complete based merely on a generated recommendation.

If the runtime or workspace is unavailable, explain that persistence is unavailable and keep the session usable. Do not fabricate saved tasks. Do not run a package installer automatically to enable persistence.

Expand All @@ -32,4 +32,4 @@ Legacy YAML memory remains readable source material. To migrate, read the user's

## Host commands

Claude project commands are the files in `commands/`; names that conflict with built-ins use the `foreman-` prefix. Use `/foreman-run` for playbooks and `/foreman-skill` for skill previews. The latter also avoids a `skill.md` / `SKILL.md` filesystem collision that hides sibling commands. Plugin commands use `/foreman:NAME`. Consult `catalog.json` for the exact map. In Codex, invoke `$foreman` with the requested operation or use an individual framework skill. Do not advertise Claude slash commands as Codex commands.
Claude project commands are the generated wrappers in `commands/`; each one points to its specification in `command-guides/`. Names that conflict with built-ins use the `foreman-` prefix. Use `/foreman-run` for playbooks and `/foreman-skill` for skill previews. The latter also avoids a `skill.md` / `SKILL.md` filesystem collision that hides sibling commands. Plugin commands use `/foreman:NAME`. Consult `catalog.json` for the exact map. In Codex, invoke `$foreman` with the requested operation or use an individual framework skill. Do not advertise Claude slash commands as Codex commands.
83 changes: 52 additions & 31 deletions .claude/catalog.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"release": {
"version": "1.1.0",
"version": "1.1.1",
"license": "MIT",
"repository": "git+https://github.com/fatihguner/foreman.git",
"homepage": "https://foreman.sh"
Expand Down Expand Up @@ -39,55 +39,55 @@
{
"id": "execution-commands",
"kind": "command",
"path": "commands/execution-commands.md",
"path": "command-guides/execution-commands.md",
"category": "execution"
},
{
"id": "implementation-commands",
"kind": "command",
"path": "commands/implementation-commands.md",
"path": "command-guides/implementation-commands.md",
"category": "implementation"
},
{
"id": "language-mode-commands",
"kind": "command",
"path": "commands/language-command.md",
"path": "command-guides/language-command.md",
"category": "meta"
},
{
"id": "memory-commands",
"kind": "command",
"path": "commands/memory-commands.md",
"path": "command-guides/memory-commands.md",
"category": "memory"
},
{
"id": "navigation-commands",
"kind": "command",
"path": "commands/navigation-commands.md",
"path": "command-guides/navigation-commands.md",
"category": "navigation"
},
{
"id": "org-politics-commands",
"kind": "command",
"path": "commands/org-politics-commands.md",
"path": "command-guides/org-politics-commands.md",
"category": "org-politics"
},
{
"id": "research-commands",
"kind": "command",
"path": "commands/research-commands.md",
"path": "command-guides/research-commands.md",
"category": "research"
},
{
"id": "simulation-commands",
"kind": "command",
"path": "commands/simulation-commands.md",
"path": "command-guides/simulation-commands.md",
"category": "simulation"
},
{
"id": "stoic-mode-commands",
"kind": "command",
"path": "commands/stoic-command.md",
"path": "command-guides/stoic-command.md",
"category": "meta"
},
{
Expand Down Expand Up @@ -309,7 +309,8 @@
"id": "organizational-alignment-playbook",
"kind": "playbook",
"path": "org-politics/organizational-alignment-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "power-dynamics-diagnosis",
Expand Down Expand Up @@ -594,114 +595,134 @@
{
"id": "acquisition-evaluation-playbook",
"kind": "playbook",
"path": "playbooks/acquisition-evaluation-playbook.md"
"path": "playbooks/acquisition-evaluation-playbook.md",
"steps": 6
},
{
"id": "board-formation-playbook",
"kind": "playbook",
"path": "playbooks/board-formation-playbook.md"
"path": "playbooks/board-formation-playbook.md",
"steps": 5
},
{
"id": "competitive-response-playbook",
"kind": "playbook",
"path": "playbooks/competitive-response-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 5
},
{
"id": "crisis-playbook",
"kind": "playbook",
"path": "playbooks/crisis-playbook.md"
"path": "playbooks/crisis-playbook.md",
"steps": 5
},
{
"id": "first-100-customers-playbook",
"kind": "playbook",
"path": "playbooks/first-100-customers-playbook.md"
"path": "playbooks/first-100-customers-playbook.md",
"steps": 6
},
{
"id": "founder-transition-playbook",
"kind": "playbook",
"path": "playbooks/founder-transition-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "fundraising-playbook",
"kind": "playbook",
"path": "playbooks/fundraising-playbook.md"
"path": "playbooks/fundraising-playbook.md",
"steps": 7
},
{
"id": "innovation-sprint-playbook",
"kind": "playbook",
"path": "playbooks/innovation-sprint-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 5
},
{
"id": "international-expansion-playbook",
"kind": "playbook",
"path": "playbooks/international-expansion-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "launch-playbook",
"kind": "playbook",
"path": "playbooks/launch-playbook.md"
"path": "playbooks/launch-playbook.md",
"steps": 6
},
{
"id": "negotiation-playbook",
"kind": "playbook",
"path": "playbooks/negotiation-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "partnership-playbook",
"kind": "playbook",
"path": "playbooks/partnership-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 5
},
{
"id": "personal-brand-playbook",
"kind": "playbook",
"path": "playbooks/personal-brand-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "pivot-playbook",
"kind": "playbook",
"path": "playbooks/pivot-playbook.md"
"path": "playbooks/pivot-playbook.md",
"steps": 6
},
{
"id": "pricing-strategy-playbook",
"kind": "playbook",
"path": "playbooks/pricing-strategy-playbook.md"
"path": "playbooks/pricing-strategy-playbook.md",
"steps": 6
},
{
"id": "product-market-fit-playbook",
"kind": "playbook",
"path": "playbooks/product-market-fit-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "remote-team-playbook",
"kind": "playbook",
"path": "playbooks/remote-team-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "scaling-playbook",
"kind": "playbook",
"path": "playbooks/scaling-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 7
},
{
"id": "strategy-reset-playbook",
"kind": "playbook",
"path": "playbooks/strategy-reset-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 7
},
{
"id": "team-rebuild-playbook",
"kind": "playbook",
"path": "playbooks/team-rebuild-playbook.md",
"category": "playbooks"
"category": "playbooks",
"steps": 6
},
{
"id": "brand-perception-research",
Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/abort.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /abort

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/playbook-commands.md and execute only /abort with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/playbook-commands.md and execute only /abort with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /about

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/meta-commands.md and execute only /about with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/meta-commands.md and execute only /about with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/apply.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /apply

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/execution-commands.md and execute only /apply with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/execution-commands.md and execute only /apply with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/back.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /back

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/playbook-commands.md and execute only /back with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/playbook-commands.md and execute only /back with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/blockers.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /blockers

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/implementation-commands.md and execute only /blockers with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/implementation-commands.md and execute only /blockers with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/check-in.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /check-in

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/implementation-commands.md and execute only /check-in with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/implementation-commands.md and execute only /check-in with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/coalition.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /coalition

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/org-politics-commands.md and execute only /coalition with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/org-politics-commands.md and execute only /coalition with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/compare.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /compare

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/output-commands.md and execute only /compare with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/output-commands.md and execute only /compare with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/decisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /decisions

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/memory-commands.md and execute only /decisions with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/memory-commands.md and execute only /decisions with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
2 changes: 1 addition & 1 deletion .claude/commands/diagnose.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ argument-hint: "[arguments]"

# Foreman /diagnose

Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/commands/execution-commands.md and execute only /diagnose with the user's arguments: $ARGUMENTS.
Read .claude/RUNTIME.md and .claude/policies/advisory.md first. Then read .claude/command-guides/execution-commands.md and execute only /diagnose with the user's arguments: $ARGUMENTS.

Use .claude/catalog.json to resolve exact content names before aliases or unique matches. Load all required supporting files from .claude. All paths in the source instructions are relative to this content directory. Persist confirmed changes through the runtime described in RUNTIME.md; never claim a write succeeded without reading its result.

Expand Down
Loading
Loading