Add /guide:introspect skill for Introspective Development#49
Merged
Conversation
New skill that audits lifecycle coverage, finds gaps in tooling and docs, and auto-fixes what it finds. Supports three trigger levels (off/remind/auto) with natural language toggle and config persistence across plugin updates. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Review Summary by QodoAdd /guide:introspect skill for Introspective Development
WalkthroughsDescription• Add /guide:introspect skill implementing Introspective Development paradigm • Audit lifecycle coverage, find gaps in tooling/docs, auto-fix approved changes • New expert-tier game-mode category (x100 multiplier) with three trigger levels • Integrate introspection tracking into game-mode scoring and feature suggestions Diagramflowchart LR
A["User runs /guide:introspect"] --> B["Scan project state"]
B --> C["Analyze four dimensions"]
C --> D["Check lifecycle coverage"]
D --> E["Report findings in plan mode"]
E --> F["Apply approved fixes"]
F --> G["Update CLAUDE.md/AGENT.md/skills"]
H["Trigger level config"] --> I["auto/remind/off setting"]
I --> J["Persists across plugin updates"]
K["Game-mode integration"] --> L["Track introspection usage"]
L --> M["Expert tier x100 multiplier"]
File Changes1. skills/introspect/SKILL.md
|
Code Review by Qodo
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new /guide:introspect skill and supporting documentation + game-mode tracking so “Introspective Development” usage is counted as a new expert-tier feature category.
Changes:
- Introduces the new
skills/introspect/SKILL.mdand an expert reference doc describing the Introspective Development paradigm. - Adds a new
introspectionexpert-tier game-mode category (x100) and wires/guide:introspectprompt tracking to it. - Updates schema migration, level-up/game-mode docs, and bats tests to reflect the new 16th category and ensure tracking remains correct.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
skills/introspect/SKILL.md |
New introspection skill instructions, including trigger-level toggle behavior and introspection workflow. |
skills/ask/references/expert/introspective-development.md |
New expert reference doc explaining the paradigm and how to use /guide:introspect. |
hooks/scripts/track-prompt.sh |
Routes /guide:introspect to the new introspection feature category before the guide:* skip rule. |
hooks/scripts/track-stop.sh |
Treats introspection as expert-tier (x100), includes it in suggestion candidates, and updates unlocked-count output to /16. |
hooks/scripts/migrate-data.sh |
Adds introspection to the EXPECTED feature list for lightweight schema migration. |
skills/game-mode/SKILL.md |
Updates the documented schema/tier table/dashboard examples for 16 categories including introspection. |
skills/level-up/SKILL.md |
Adds introspection to the dependency graph, roadmap examples, and hint text. |
tests/helpers/setup.sh |
Extends the test game-data.json template to include introspection. |
tests/track-prompt.bats |
Adds coverage that /guide:introspect (with/without args) increments the introspection count. |
tests/track-stop.bats |
Updates suggestedFeatures fixture to include introspection to match the expanded category set. |
tests/migrate-data.bats |
Updates category count and expected-category loops from 15 → 16. |
.claude-plugin/plugin.json |
Bumps plugin version to 2.17.0. |
.claude-plugin/marketplace.json |
Bumps marketplace version to 2.17.0. |
CLAUDE.md |
Updates repo structure tree + skill list to include /guide:introspect. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
![qodo-code-review[bot]](https://avatars.githubusercontent.com/in/484649?s=60&v=4){kind=small}
…sistence - Update test comment "All 15" → "All 16" categories (Copilot) - Remove expert-tier introspection from level 1-2 suggestedFeatures (Copilot) - Handle missing game-data.json in toggle flow — create dir/file if needed (Qodo) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
OriNachum
added a commit
that referenced
this pull request
Apr 11, 2026
… skill Fixes from running /guide:introspect on this repo after PR #49: - Remove AGENT.md references from skill (Agentic Folders deferred) - Add introspect skill to README.md and index.md - Add markdownlint config to repo root for contributor consistency - Add "Clear" phase guidance to CLAUDE.md Git Workflow section - Fix ordered list numbering in SKILL.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3 tasks
OriNachum
added a commit
that referenced
this pull request
Apr 11, 2026
* Apply introspection findings: update docs, add linting config, refine skill Fixes from running /guide:introspect on this repo after PR #49: - Remove AGENT.md references from skill (Agentic Folders deferred) - Add introspect skill to README.md and index.md - Add markdownlint config to repo root for contributor consistency - Add "Clear" phase guidance to CLAUDE.md Git Workflow section - Fix ordered list numbering in SKILL.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Fix review comments: version bump, Contributing count, Agentic Folders ref - Bump version 2.17.0 → 2.17.1 (patch: content changes to shipped skill) - Fix Contributing section: "five skills" → "seven skills", add introspect/ - Soften Agentic Folders reference in Origin section (future consideration) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/guide:introspectskill implementing the Introspective Development paradigm — audits lifecycle coverage, finds gaps in tooling and docs, and auto-fixes approved changesintrospectiongame-mode category (Expert tier, x100 multiplier) — tracked via/guide:introspectslash commandCloses #40
Files changed (14)
skills/introspect/SKILL.mdskills/ask/references/expert/introspective-development.mdhooks/scripts/track-prompt.shguide:introspect→ introspection (beforeguide:*catch-all)hooks/scripts/track-stop.shhooks/scripts/migrate-data.shskills/game-mode/SKILL.mdskills/level-up/SKILL.mdtests/helpers/setup.shtests/track-prompt.bats/guide:introspecttrackingtests/track-stop.batstests/migrate-data.bats.claude-plugin/plugin.json.claude-plugin/marketplace.jsonCLAUDE.mdTest plan
/guide:introspecton a project — should produce meaningful report/guide:introspect auto— should update frontmatter and ask about PR skill🤖 Generated with Claude Code