@przeprogramowani/10x-cli 1.22.0 → 1.22.2

package/README.md

@@ -128,6 +128,8 @@ artifacts/rules before applying; repeat a skill filter for a narrow update:
 10x_cli auth --status
 # If login is needed: 10x_cli auth (email or Circle); see auth commands below.
 10x_cli list --course 10xdevs4
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -143,7 +145,9 @@ artifacts/rules before applying; repeat a skill filter for a narrow update:
 
 The guide uses lesson 1's existing 10xCards example and produces
 `context/foundation/shape-notes.md`, then `context/foundation/prd.md`.
-Read all three installed skill trees; PRD requires the sibling
+Lesson setup installs all four skill trees. Use `10x-idea-check` and its references
+first when you want to assess an idea; it is optional before init → shape → PRD.
+Read the installed entrypoints and their references; PRD requires the sibling
 `.claude/skills/10x-shape/references/prd-schema.md`. Preserve existing outputs and
 follow the skills' collision choices. `CLAUDE-m1l1` is a separate lesson rule;
 see the guide for prerequisite checks without a full-get fallback. `10x-plan`

package/dist/index.mjs

@@ -3183,7 +3183,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "1.22.0",
+  version: "1.22.2",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -3208,10 +3208,14 @@ var package_default = {
     build: "bun build src/index.ts --outfile dist/index.mjs --target node",
     "build:binary": "bun build --compile --minify src/index.ts --outfile dist/10x",
     "generate-types": "bun run scripts/generate-types.ts",
-    typecheck: "tsc --noEmit",
+    typecheck: "node node_modules/typescript/bin/tsc --noEmit",
     test: "bun test",
     lint: "bun run --bun node_modules/oxlint/bin/oxlint .",
-    "validate:cli-skills": "node scripts/validate-cli-skills.mjs"
+    "validate:cli-skills": "node scripts/validate-cli-skills.mjs",
+    "quality:fast": "node .quality/run.mjs fast",
+    "quality:affected": "node .quality/run.mjs affected",
+    "quality:gate": "node .quality/run.mjs gate",
+    "quality:risk": "node .quality/run.mjs risk"
   },
   dependencies: {
     "@clack/prompts": "0.9.1",
@@ -7571,9 +7575,15 @@ Auth: valid / login required / unknown; live course access and module state
 Setup helper: actual path, public or CLI owner, observed source ref if known
 Guide helper: actual path, owner and source ref if known; full reference present
 Readiness: verified checks; remaining release/network/access issues, if any
-Next task: guide's download → use → sync journey, retaining this context
+Next task: guide's lesson setup (idea-check/init/shape/prd) → use → sync journey, or the user's narrower request
 \`\`\`
 
+For lesson 1 setup, carry forward all four skills in the handoff:
+\`10x-idea-check\`, \`10x-init\`, \`10x-shape\` and \`10x-prd\`, with their references.
+Idea assessment is optional to run, not a reason to omit its files during lesson
+setup. A request for one specific skill remains a narrower download. Verify
+materialized files separately from native slash-command discovery.
+
 Once ready, continue in guide without rerunning installation or asking the user
 to repeat choices already supplied. Report remaining blockers precisely if the
 download cannot yet run; do not present preparation as a completed real journey.
@@ -7744,7 +7754,7 @@ already managed by CLI should be used/updated through CLI, not overwritten here.
 ### CLI channel
 
 Use this channel after setup/auth and only with verified skill-filter support and
-available v4 content. These helpers and the launch chain \`10x-init\`, \`10x-shape\`, \`10x-prd\` belong to m1l1
+available v4 content. These helpers and the lesson skills \`10x-idea-check\`, \`10x-init\`, \`10x-shape\`, \`10x-prd\` belong to m1l1
 and inherit course membership and module availability. Their source membership
 does not prove that the content has been published or unlocked.
 
@@ -7783,11 +7793,17 @@ place two updaters over the same files. Normal use does not require any takeover
 
 ## Download, use, update
 
-The launch example is lesson 1's existing 10xCards: init → shape → PRD.
+Prepare lesson 1's four skills, including \`10x-idea-check\` with its references.
+The launch example remains the existing 10xCards: init → shape → PRD.
+Idea assessment is optional to run before that chain; install its tree during
+lesson setup so the learner can use it. Retain a narrower scope when the user
+explicitly requested only a specific skill.
 \`10x-plan\` is not available for the launch demonstration. After capability and
 content checks for each name, inspect each preview before its corresponding write:
 
 \`\`\`bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -7796,10 +7812,15 @@ content checks for each name, inspect each preview before its corresponding writ
 10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
 \`\`\`
 
-Require the complete three trees and inspect each installed entrypoint/reference.
+Require the complete four trees and inspect each installed entrypoint/reference.
 All checks below must succeed before use; stop on any failure:
 
 \`\`\`bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -7809,11 +7830,11 @@ test -s .claude/skills/10x-prd/../10x-shape/references/prd-schema.md
 
 PRD reads \`../10x-shape/references/prd-schema.md\` relative to its SKILL.md;
 isolated PRD download is insufficient. These are the source minimum: preserve
-additional supporting files in the selected release. Inspect all three names in
+additional supporting files in the selected release. Inspect all four names in
 \`lessons.m1l1.skills\`, their hashes in \`files.skills\`, and the project edition
 binding. Partial downloads do not establish complete lesson freshness/release identity.
 Membership in source is candidate evidence; actual filtered availability, full PL
-references and release identity still need verification for all three names.
+references and release identity still need verification for all four names.
 
 \`CLAUDE-m1l1\` is a separate lesson rule and is not included in these filtered gets.
 The inspected three skill sources do not require it for the chain. This is not
@@ -7822,8 +7843,10 @@ require it, inspect an existing rule's provenance, or report the missing
 prerequisite and ask the lesson/release owner for a supported route before that
 step. Never invent a command, overwrite a rule or fall back to full lesson get.
 
-Have the agent explicitly read each installed SKILL.md and its references in
-order: init preserves/scaffolds context directories; shape conducts the actual
+If the learner wants to assess their idea before shaping, have the agent read
+\`.claude/skills/10x-idea-check/SKILL.md\` and its references and follow that skill.
+A learner ready to shape can skip assessment. Then read the chain's entrypoints
+and references in order: init preserves/scaffolds context directories; shape conducts the actual
 10xCards discovery with the learner and writes
 \`context/foundation/shape-notes.md\`; after the learner approves those notes, PRD
 uses them and the sibling schema to produce \`context/foundation/prd.md\`.
@@ -7834,7 +7857,7 @@ work. Stop at PRD, without stack selection or implementation. Download alone is
 not use; native slash/$ discovery needs separate agent evidence. Keep private
 lesson text out of public fixtures. The guide supplies the detailed agent steps.
 
-Sync below refreshes entire recorded lessons, not only the three skill filters.
+Sync below refreshes entire recorded lessons, not only the four skill filters.
 Preview may include other skills, prompts, configs and course rules; apply only
 when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.
@@ -7974,10 +7997,15 @@ refresh transparently; re-login is needed only when refresh cannot recover them.
 
 The launch exercise follows lesson 1, “Od pomysłu do PRD”, using its existing
 10xCards example. \`10x-plan\` is not part of this launch demonstration.
-After checking each name's capability and availability, download three separate
-complete selected skill trees. Inspect each dry-run before its corresponding write:
+Prepare all four lesson skills: \`10x-idea-check\`, \`10x-init\`, \`10x-shape\` and
+\`10x-prd\`. Idea assessment is optional to run; its files should still be available
+when preparing lesson 1. If the user requested only a specific skill, retain that
+narrower scope. After checking each name's capability and availability, download
+four separate complete selected skill trees. Inspect each dry-run before its corresponding write:
 
 \`\`\`bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -7991,6 +8019,11 @@ chosen macOS/zsh exercise directory, each of these checks must succeed before us
 (stop on any failure; do not infer success from the last check alone):
 
 \`\`\`bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -8003,14 +8036,14 @@ own directory. A standalone PRD tree is insufficient. Read all installed
 entrypoints and every reference they require; the paths above are the known
 source minimum, not permission to discard extra files from a published bundle.
 Also inspect \`.claude/.10x-cli-manifest.json\`: \`lessons.m1l1.skills\` must include
-all three names, with file hashes in \`files.skills\`. These are lesson-owned
+all four names, with file hashes in \`files.skills\`. These are lesson-owned
 partial downloads, not independent owners. Inspect \`.10x-cli.json\` for the course
 binding; partial downloads do not establish a complete lesson release identity.
 
 CLI 1.21.0 is published with v4 and filtered skill downloads; production m1l1 EN/PL
-contains init/shape/prd and their references. These revised helpers are a separate
+contains idea-check/init/shape/prd and their references. These revised helpers are a separate
 source change, not proof that their course copies have been published.
-Verify all three names against the actual selected release. If any name, schema,
+Verify all four names against the actual selected release. If any name, schema,
 owner or release is missing/mismatched, preserve the precise error and stop the
 exercise; never silently substitute a whole lesson, another course or filtered get.
 
@@ -8035,7 +8068,11 @@ the learner's actual answers from lesson 1. If those inputs are absent, ask for
 them; do not invent product requirements, a replacement task.md or a ready-made
 plan. Keep private lesson text out of public fixtures and transcripts.
 Do not assume native slash/$ discovery or automatic activation from npm install.
-Give the agent explicit local paths and work through these steps separately:
+Give the agent explicit local paths. If the learner wants to assess whether an
+idea fits their experience, time and course goals, first read
+\`.claude/skills/10x-idea-check/SKILL.md\` and its references and follow that skill.
+Do not make assessment a prerequisite when the learner is ready to shape.
+Then work through these steps separately:
 
 1. Read \`.claude/skills/10x-init/SKILL.md\` and follow it in the chosen project.
    Inspect the create-if-absent context/changes, context/archive and
@@ -8074,7 +8111,7 @@ workaround:
 \`\`\`
 
 Normal sync refreshes the full lessons recorded in the manifest, not just the
-three selected skills. \`--all\` broadens scope to unlocked lessons and is not needed
+four selected skills. \`--all\` broadens scope to unlocked lessons and is not needed
 for this exercise. Missing managed files should be repaired; local edits should
 remain visible as conflicts or preserved files. Read all report outcomes and
 resource counts even if exit is 0: skipped conflicts alone are not process errors.
@@ -8147,6 +8184,7 @@ visible. Doctor exit 78 can coexist with outer JSON \`status: "ok"\`.
 | Locked or unpublished v4 | Inspect module availability/release evidence; do not bypass the gate or fall back to v3. |
 | Unsupported name/missing index | Verify exact CLI package and content release; preserve the error for the release owner. |
 | Network/API failure | Keep diagnostics, retry the same context when service returns; no config reset. |
+| Missing \`10x-idea-check\` after setup | Older helper journeys selected only init/shape/prd. Check the actual commands, selected profile path and manifest; use the idea-check preview/get above to add its complete tree. If the files already exist, read that exact SKILL.md and check the agent's discovery/reload behavior before reinstalling. An absent slash command alone does not prove missing files. |
 | Wrong directory/profile | Recheck cwd and explicit flags; a fresh project may legitimately have no tool directory. |
 | Signature/release mismatch | Preserve failure and source identity; do not disable verification or reuse unrelated bytes. |
 | Edition/manifest conflict | Preserve binding and manifests for repair; use a separate v4 project rather than deleting them. |
@@ -8322,7 +8360,7 @@ already managed by CLI should be used/updated through CLI, not overwritten here.
 ### CLI channel
 
 Use this channel after setup/auth and only with verified skill-filter support and
-available v4 content. These helpers and the launch chain \`10x-init\`, \`10x-shape\`, \`10x-prd\` belong to m1l1
+available v4 content. These helpers and the lesson skills \`10x-idea-check\`, \`10x-init\`, \`10x-shape\`, \`10x-prd\` belong to m1l1
 and inherit course membership and module availability. Their source membership
 does not prove that the content has been published or unlocked.
 
@@ -8361,11 +8399,17 @@ place two updaters over the same files. Normal use does not require any takeover
 
 ## Download, use, update
 
-The launch example is lesson 1's existing 10xCards: init → shape → PRD.
+Prepare lesson 1's four skills, including \`10x-idea-check\` with its references.
+The launch example remains the existing 10xCards: init → shape → PRD.
+Idea assessment is optional to run before that chain; install its tree during
+lesson setup so the learner can use it. Retain a narrower scope when the user
+explicitly requested only a specific skill.
 \`10x-plan\` is not available for the launch demonstration. After capability and
 content checks for each name, inspect each preview before its corresponding write:
 
 \`\`\`bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -8374,10 +8418,15 @@ content checks for each name, inspect each preview before its corresponding writ
 10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
 \`\`\`
 
-Require the complete three trees and inspect each installed entrypoint/reference.
+Require the complete four trees and inspect each installed entrypoint/reference.
 All checks below must succeed before use; stop on any failure:
 
 \`\`\`bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -8387,11 +8436,11 @@ test -s .claude/skills/10x-prd/../10x-shape/references/prd-schema.md
 
 PRD reads \`../10x-shape/references/prd-schema.md\` relative to its SKILL.md;
 isolated PRD download is insufficient. These are the source minimum: preserve
-additional supporting files in the selected release. Inspect all three names in
+additional supporting files in the selected release. Inspect all four names in
 \`lessons.m1l1.skills\`, their hashes in \`files.skills\`, and the project edition
 binding. Partial downloads do not establish complete lesson freshness/release identity.
 Membership in source is candidate evidence; actual filtered availability, full PL
-references and release identity still need verification for all three names.
+references and release identity still need verification for all four names.
 
 \`CLAUDE-m1l1\` is a separate lesson rule and is not included in these filtered gets.
 The inspected three skill sources do not require it for the chain. This is not
@@ -8400,8 +8449,10 @@ require it, inspect an existing rule's provenance, or report the missing
 prerequisite and ask the lesson/release owner for a supported route before that
 step. Never invent a command, overwrite a rule or fall back to full lesson get.
 
-Have the agent explicitly read each installed SKILL.md and its references in
-order: init preserves/scaffolds context directories; shape conducts the actual
+If the learner wants to assess their idea before shaping, have the agent read
+\`.claude/skills/10x-idea-check/SKILL.md\` and its references and follow that skill.
+A learner ready to shape can skip assessment. Then read the chain's entrypoints
+and references in order: init preserves/scaffolds context directories; shape conducts the actual
 10xCards discovery with the learner and writes
 \`context/foundation/shape-notes.md\`; after the learner approves those notes, PRD
 uses them and the sibling schema to produce \`context/foundation/prd.md\`.
@@ -8412,7 +8463,7 @@ work. Stop at PRD, without stack selection or implementation. Download alone is
 not use; native slash/$ discovery needs separate agent evidence. Keep private
 lesson text out of public fixtures. The guide supplies the detailed agent steps.
 
-Sync below refreshes entire recorded lessons, not only the three skill filters.
+Sync below refreshes entire recorded lessons, not only the four skill filters.
 Preview may include other skills, prompts, configs and course rules; apply only
 when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "1.22.0",
+  "version": "1.22.2",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",
@@ -25,10 +25,14 @@
     "build": "bun build src/index.ts --outfile dist/index.mjs --target node",
     "build:binary": "bun build --compile --minify src/index.ts --outfile dist/10x",
     "generate-types": "bun run scripts/generate-types.ts",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "node node_modules/typescript/bin/tsc --noEmit",
     "test": "bun test",
     "lint": "bun run --bun node_modules/oxlint/bin/oxlint .",
-    "validate:cli-skills": "node scripts/validate-cli-skills.mjs"
+    "validate:cli-skills": "node scripts/validate-cli-skills.mjs",
+    "quality:fast": "node .quality/run.mjs fast",
+    "quality:affected": "node .quality/run.mjs affected",
+    "quality:gate": "node .quality/run.mjs gate",
+    "quality:risk": "node .quality/run.mjs risk"
   },
   "dependencies": {
     "@clack/prompts": "0.9.1",
@@ -53,4 +57,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/skills/10x-cli-guide/SKILL.md

@@ -79,10 +79,15 @@ refresh transparently; re-login is needed only when refresh cannot recover them.
 
 The launch exercise follows lesson 1, “Od pomysłu do PRD”, using its existing
 10xCards example. `10x-plan` is not part of this launch demonstration.
-After checking each name's capability and availability, download three separate
-complete selected skill trees. Inspect each dry-run before its corresponding write:
+Prepare all four lesson skills: `10x-idea-check`, `10x-init`, `10x-shape` and
+`10x-prd`. Idea assessment is optional to run; its files should still be available
+when preparing lesson 1. If the user requested only a specific skill, retain that
+narrower scope. After checking each name's capability and availability, download
+four separate complete selected skill trees. Inspect each dry-run before its corresponding write:
 
 ```bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -96,6 +101,11 @@ chosen macOS/zsh exercise directory, each of these checks must succeed before us
 (stop on any failure; do not infer success from the last check alone):
 
 ```bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -108,14 +118,14 @@ own directory. A standalone PRD tree is insufficient. Read all installed
 entrypoints and every reference they require; the paths above are the known
 source minimum, not permission to discard extra files from a published bundle.
 Also inspect `.claude/.10x-cli-manifest.json`: `lessons.m1l1.skills` must include
-all three names, with file hashes in `files.skills`. These are lesson-owned
+all four names, with file hashes in `files.skills`. These are lesson-owned
 partial downloads, not independent owners. Inspect `.10x-cli.json` for the course
 binding; partial downloads do not establish a complete lesson release identity.
 
 CLI 1.21.0 is published with v4 and filtered skill downloads; production m1l1 EN/PL
-contains init/shape/prd and their references. These revised helpers are a separate
+contains idea-check/init/shape/prd and their references. These revised helpers are a separate
 source change, not proof that their course copies have been published.
-Verify all three names against the actual selected release. If any name, schema,
+Verify all four names against the actual selected release. If any name, schema,
 owner or release is missing/mismatched, preserve the precise error and stop the
 exercise; never silently substitute a whole lesson, another course or filtered get.
 
@@ -140,7 +150,11 @@ the learner's actual answers from lesson 1. If those inputs are absent, ask for
 them; do not invent product requirements, a replacement task.md or a ready-made
 plan. Keep private lesson text out of public fixtures and transcripts.
 Do not assume native slash/$ discovery or automatic activation from npm install.
-Give the agent explicit local paths and work through these steps separately:
+Give the agent explicit local paths. If the learner wants to assess whether an
+idea fits their experience, time and course goals, first read
+`.claude/skills/10x-idea-check/SKILL.md` and its references and follow that skill.
+Do not make assessment a prerequisite when the learner is ready to shape.
+Then work through these steps separately:
 
 1. Read `.claude/skills/10x-init/SKILL.md` and follow it in the chosen project.
    Inspect the create-if-absent context/changes, context/archive and
@@ -179,7 +193,7 @@ workaround:
 ```
 
 Normal sync refreshes the full lessons recorded in the manifest, not just the
-three selected skills. `--all` broadens scope to unlocked lessons and is not needed
+four selected skills. `--all` broadens scope to unlocked lessons and is not needed
 for this exercise. Missing managed files should be repaired; local edits should
 remain visible as conflicts or preserved files. Read all report outcomes and
 resource counts even if exit is 0: skipped conflicts alone are not process errors.
@@ -252,6 +266,7 @@ visible. Doctor exit 78 can coexist with outer JSON `status: "ok"`.
 | Locked or unpublished v4 | Inspect module availability/release evidence; do not bypass the gate or fall back to v3. |
 | Unsupported name/missing index | Verify exact CLI package and content release; preserve the error for the release owner. |
 | Network/API failure | Keep diagnostics, retry the same context when service returns; no config reset. |
+| Missing `10x-idea-check` after setup | Older helper journeys selected only init/shape/prd. Check the actual commands, selected profile path and manifest; use the idea-check preview/get above to add its complete tree. If the files already exist, read that exact SKILL.md and check the agent's discovery/reload behavior before reinstalling. An absent slash command alone does not prove missing files. |
 | Wrong directory/profile | Recheck cwd and explicit flags; a fresh project may legitimately have no tool directory. |
 | Signature/release mismatch | Preserve failure and source identity; do not disable verification or reuse unrelated bytes. |
 | Edition/manifest conflict | Preserve binding and manifests for repair; use a separate v4 project rather than deleting them. |

package/skills/10x-cli-guide/references/compatibility.md

@@ -162,7 +162,7 @@ already managed by CLI should be used/updated through CLI, not overwritten here.
 ### CLI channel
 
 Use this channel after setup/auth and only with verified skill-filter support and
-available v4 content. These helpers and the launch chain `10x-init`, `10x-shape`, `10x-prd` belong to m1l1
+available v4 content. These helpers and the lesson skills `10x-idea-check`, `10x-init`, `10x-shape`, `10x-prd` belong to m1l1
 and inherit course membership and module availability. Their source membership
 does not prove that the content has been published or unlocked.
 
@@ -201,11 +201,17 @@ place two updaters over the same files. Normal use does not require any takeover
 
 ## Download, use, update
 
-The launch example is lesson 1's existing 10xCards: init → shape → PRD.
+Prepare lesson 1's four skills, including `10x-idea-check` with its references.
+The launch example remains the existing 10xCards: init → shape → PRD.
+Idea assessment is optional to run before that chain; install its tree during
+lesson setup so the learner can use it. Retain a narrower scope when the user
+explicitly requested only a specific skill.
 `10x-plan` is not available for the launch demonstration. After capability and
 content checks for each name, inspect each preview before its corresponding write:
 
 ```bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -214,10 +220,15 @@ content checks for each name, inspect each preview before its corresponding writ
 10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
 ```
 
-Require the complete three trees and inspect each installed entrypoint/reference.
+Require the complete four trees and inspect each installed entrypoint/reference.
 All checks below must succeed before use; stop on any failure:
 
 ```bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -227,11 +238,11 @@ test -s .claude/skills/10x-prd/../10x-shape/references/prd-schema.md
 
 PRD reads `../10x-shape/references/prd-schema.md` relative to its SKILL.md;
 isolated PRD download is insufficient. These are the source minimum: preserve
-additional supporting files in the selected release. Inspect all three names in
+additional supporting files in the selected release. Inspect all four names in
 `lessons.m1l1.skills`, their hashes in `files.skills`, and the project edition
 binding. Partial downloads do not establish complete lesson freshness/release identity.
 Membership in source is candidate evidence; actual filtered availability, full PL
-references and release identity still need verification for all three names.
+references and release identity still need verification for all four names.
 
 `CLAUDE-m1l1` is a separate lesson rule and is not included in these filtered gets.
 The inspected three skill sources do not require it for the chain. This is not
@@ -240,8 +251,10 @@ require it, inspect an existing rule's provenance, or report the missing
 prerequisite and ask the lesson/release owner for a supported route before that
 step. Never invent a command, overwrite a rule or fall back to full lesson get.
 
-Have the agent explicitly read each installed SKILL.md and its references in
-order: init preserves/scaffolds context directories; shape conducts the actual
+If the learner wants to assess their idea before shaping, have the agent read
+`.claude/skills/10x-idea-check/SKILL.md` and its references and follow that skill.
+A learner ready to shape can skip assessment. Then read the chain's entrypoints
+and references in order: init preserves/scaffolds context directories; shape conducts the actual
 10xCards discovery with the learner and writes
 `context/foundation/shape-notes.md`; after the learner approves those notes, PRD
 uses them and the sibling schema to produce `context/foundation/prd.md`.
@@ -252,7 +265,7 @@ work. Stop at PRD, without stack selection or implementation. Download alone is
 not use; native slash/$ discovery needs separate agent evidence. Keep private
 lesson text out of public fixtures. The guide supplies the detailed agent steps.
 
-Sync below refreshes entire recorded lessons, not only the three skill filters.
+Sync below refreshes entire recorded lessons, not only the four skill filters.
 Preview may include other skills, prompts, configs and course rules; apply only
 when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.

package/skills/10x-cli-setup/SKILL.md

@@ -125,9 +125,15 @@ Auth: valid / login required / unknown; live course access and module state
 Setup helper: actual path, public or CLI owner, observed source ref if known
 Guide helper: actual path, owner and source ref if known; full reference present
 Readiness: verified checks; remaining release/network/access issues, if any
-Next task: guide's download → use → sync journey, retaining this context
+Next task: guide's lesson setup (idea-check/init/shape/prd) → use → sync journey, or the user's narrower request
 ```
 
+For lesson 1 setup, carry forward all four skills in the handoff:
+`10x-idea-check`, `10x-init`, `10x-shape` and `10x-prd`, with their references.
+Idea assessment is optional to run, not a reason to omit its files during lesson
+setup. A request for one specific skill remains a narrower download. Verify
+materialized files separately from native slash-command discovery.
+
 Once ready, continue in guide without rerunning installation or asking the user
 to repeat choices already supplied. Report remaining blockers precisely if the
 download cannot yet run; do not present preparation as a completed real journey.

package/skills/10x-cli-setup/references/compatibility.md

@@ -162,7 +162,7 @@ already managed by CLI should be used/updated through CLI, not overwritten here.
 ### CLI channel
 
 Use this channel after setup/auth and only with verified skill-filter support and
-available v4 content. These helpers and the launch chain `10x-init`, `10x-shape`, `10x-prd` belong to m1l1
+available v4 content. These helpers and the lesson skills `10x-idea-check`, `10x-init`, `10x-shape`, `10x-prd` belong to m1l1
 and inherit course membership and module availability. Their source membership
 does not prove that the content has been published or unlocked.
 
@@ -201,11 +201,17 @@ place two updaters over the same files. Normal use does not require any takeover
 
 ## Download, use, update
 
-The launch example is lesson 1's existing 10xCards: init → shape → PRD.
+Prepare lesson 1's four skills, including `10x-idea-check` with its references.
+The launch example remains the existing 10xCards: init → shape → PRD.
+Idea assessment is optional to run before that chain; install its tree during
+lesson setup so the learner can use it. Retain a narrower scope when the user
+explicitly requested only a specific skill.
 `10x-plan` is not available for the launch demonstration. After capability and
 content checks for each name, inspect each preview before its corresponding write:
 
 ```bash
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
 10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
 10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
@@ -214,10 +220,15 @@ content checks for each name, inspect each preview before its corresponding writ
 10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
 ```
 
-Require the complete three trees and inspect each installed entrypoint/reference.
+Require the complete four trees and inspect each installed entrypoint/reference.
 All checks below must succeed before use; stop on any failure:
 
 ```bash
+test -s .claude/skills/10x-idea-check/SKILL.md
+test -s .claude/skills/10x-idea-check/references/examples.md
+test -s .claude/skills/10x-idea-check/references/assessment-guide.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-dates.md
+test -s .claude/skills/10x-idea-check/references/10xdevs-4-certification.md
 test -s .claude/skills/10x-init/SKILL.md
 test -s .claude/skills/10x-shape/SKILL.md
 test -s .claude/skills/10x-shape/references/prd-schema.md
@@ -227,11 +238,11 @@ test -s .claude/skills/10x-prd/../10x-shape/references/prd-schema.md
 
 PRD reads `../10x-shape/references/prd-schema.md` relative to its SKILL.md;
 isolated PRD download is insufficient. These are the source minimum: preserve
-additional supporting files in the selected release. Inspect all three names in
+additional supporting files in the selected release. Inspect all four names in
 `lessons.m1l1.skills`, their hashes in `files.skills`, and the project edition
 binding. Partial downloads do not establish complete lesson freshness/release identity.
 Membership in source is candidate evidence; actual filtered availability, full PL
-references and release identity still need verification for all three names.
+references and release identity still need verification for all four names.
 
 `CLAUDE-m1l1` is a separate lesson rule and is not included in these filtered gets.
 The inspected three skill sources do not require it for the chain. This is not
@@ -240,8 +251,10 @@ require it, inspect an existing rule's provenance, or report the missing
 prerequisite and ask the lesson/release owner for a supported route before that
 step. Never invent a command, overwrite a rule or fall back to full lesson get.
 
-Have the agent explicitly read each installed SKILL.md and its references in
-order: init preserves/scaffolds context directories; shape conducts the actual
+If the learner wants to assess their idea before shaping, have the agent read
+`.claude/skills/10x-idea-check/SKILL.md` and its references and follow that skill.
+A learner ready to shape can skip assessment. Then read the chain's entrypoints
+and references in order: init preserves/scaffolds context directories; shape conducts the actual
 10xCards discovery with the learner and writes
 `context/foundation/shape-notes.md`; after the learner approves those notes, PRD
 uses them and the sibling schema to produce `context/foundation/prd.md`.
@@ -252,7 +265,7 @@ work. Stop at PRD, without stack selection or implementation. Download alone is
 not use; native slash/$ discovery needs separate agent evidence. Keep private
 lesson text out of public fixtures. The guide supplies the detailed agent steps.
 
-Sync below refreshes entire recorded lessons, not only the three skill filters.
+Sync below refreshes entire recorded lessons, not only the four skill filters.
 Preview may include other skills, prompts, configs and course rules; apply only
 when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.