docs(product): define Specorator product ladder#435
Conversation
Add Product Ladder section to docs/specorator-product/product.md — four layers (Markdown core, CLI runtime, harness adapter, runtime extensions) with entry requirements. Map each persona to its ladder layer in docs/onboarding/personas.md. Add a no-runtime-required callout to the README Get Started section so the adoption model is clear before the Claude Code install steps. Closes #347.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9387fa26a3
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
/specorator:init shells out to the specorator binary (install guide line 15), so Layer 2 (Claude Code plugin) depends on Layer 1 (CLI runtime). Clarify the entry requirement accordingly.
|
Fixed in c7f6374 — Layer 2 entry requirement now reads: "Layer 1 (CLI runtime) plus Claude Code and the plugin install; |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: c7f6374bd7
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
personas.md intro implied layers are dependency-free, contradicting the Layer 2→Layer 1 prerequisite already documented in the ladder. Reword to direct users to check entry requirements before skipping.
|
fe78351 — personas.md intro reworded to: "Later layers add convenience but may depend on earlier ones — check the ladder's entry requirements before skipping a layer." |
2 participants
Summary
docs/specorator-product/product.md— four layers (Markdown core → CLI runtime → Claude Code plugin → runtime extensions) with entry requirements and stability notes.docs/onboarding/personas.mdto its ladder layer so CTAs reflect the appropriate entry point.## Get Started In 5 Minutessection so the adoption model is visible before the install steps.Closes #347.
Test plan
npm run check:frontmatterpassesnpm run check:linkspassesnpm run check:specspassesdocs/specorator-product/tech.md#runtime-and-plugin-boundaries(same four-layer model, consistent language)🤖 Generated with Claude Code