Skip to content

Commit c2e8f0f

Browse files
cli: prep for npm publish — fix bin path, add metadata + CLI README
- Drop the `./` prefix on `bin.mogkit` — npm strict mode was stripping the entry on publish, which would have shipped a package with no executable. Now `npx mogkit` will actually work post-publish. - Add homepage, repository (with `directory: cli` so npm shows the right monorepo subpath), bugs, and keywords for discoverability. - Add a cli/README.md so the npm package page has useful content instead of inheriting nothing from the monorepo root. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent c95dc47 commit c2e8f0f

2 files changed

Lines changed: 78 additions & 1 deletion

File tree

cli/README.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# mogkit
2+
3+
The open-source toolkit for product managers. Scaffolds a Claude Code-ready
4+
PM workspace and installs the 13 mogkit skills.
5+
6+
```bash
7+
npx mogkit init my-workspace
8+
cd my-workspace
9+
mogkit doctor
10+
```
11+
12+
Then open the workspace in [Claude Code](https://claude.com/claude-code) and
13+
run any skill from `.claude/skills/`.
14+
15+
## Commands
16+
17+
| Command | What it does |
18+
|---|---|
19+
| `mogkit init [dir]` | Scaffold a workspace; `git init`; install all 13 skills |
20+
| `mogkit add` | Interactive ingest of a file into `sources/` with a type tag |
21+
| `mogkit status` | Corpus health report (count, type spread, gaps) |
22+
| `mogkit skills list` | List bundled skills + install state |
23+
| `mogkit skills add <name>` | Install a specific skill into `.claude/skills/` |
24+
| `mogkit doctor` | Verify your setup; plain-language fixes for what's broken |
25+
26+
## What's in a workspace
27+
28+
```
29+
my-workspace/
30+
├─ CLAUDE.md # orients every Claude Code session in this workspace
31+
├─ sources/ # raw research; versioned; grows over time
32+
├─ graph/ # graph.json + graph.md (generated by `graphify`)
33+
├─ knowledge/ # outputs of interrogation skills land here
34+
└─ .claude/skills/ # all 13 skills installed
35+
```
36+
37+
## The 13 skills
38+
39+
**Standalone (single-shot, paste-input):**
40+
`metrics-tree`, `spec-stress-test`, `narrative-review`, `tradeoff-frame`,
41+
`stakeholder-map`, `launch-readiness`, `interview-coach`
42+
43+
**Discovery engine (corpus-backed, stateful):**
44+
`graphify`, `discovery-query`, `assumption-audit`, `prd-interrogate`,
45+
`interview-guide`, `synthesis-map`
46+
47+
## Principles
48+
49+
- **Interrogator, not generator** — no skill outputs a finished deliverable
50+
- **Provenance or it doesn't exist** — every claim traces to a source quote
51+
- **Cold-start honesty** — on a thin corpus, the skills say so loudly
52+
- **One deep system, many sharp tools** — Discovery is the only stateful engine
53+
- **The CLI is thin** — no LLM calls, no API key, zero SaaS deps
54+
55+
Full docs, the site, and the Workflow Library:
56+
<https://github.com/Waddling-Penguin/mogkit>
57+
58+
MIT licensed. Out-craft the room.

cli/package.json

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,27 @@
44
"description": "mogkit — the open-source toolkit for product managers. Scaffolds a PM workspace and installs Claude Code skills. Out-craft the room.",
55
"license": "MIT",
66
"type": "module",
7+
"homepage": "https://github.com/Waddling-Penguin/mogkit",
8+
"repository": {
9+
"type": "git",
10+
"url": "git+https://github.com/Waddling-Penguin/mogkit.git",
11+
"directory": "cli"
12+
},
13+
"bugs": {
14+
"url": "https://github.com/Waddling-Penguin/mogkit/issues"
15+
},
16+
"keywords": [
17+
"product-management",
18+
"pm",
19+
"cli",
20+
"claude-code",
21+
"discovery",
22+
"scaffold",
23+
"skills",
24+
"workspace"
25+
],
726
"bin": {
8-
"mogkit": "./dist/index.js"
27+
"mogkit": "dist/index.js"
928
},
1029
"files": [
1130
"dist",

0 commit comments

Comments
 (0)