القائمة
Detect project maturity stage (new/early/mid/mature) from file structure and route to appropriate onboarding workflow
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/oimiragieo/agent-studio --skill project-stage-detectionيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Agent frontmatter enhancements — disallowedTools, mcpServers scoping, fork_eligible field
Context management — pre-compact persistence, threshold alignment, microcompact/circuit breaker detection
Hook enhancements — updatedInput for bash safety prefixes, suppressOutput for verbose blocks, denial-based routing feedback
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | project-stage-detection |
| description | Detect project maturity stage (new/early/mid/mature) from file structure and route to appropriate onboarding workflow |
| version | 1.0.0 |
| model | sonnet |
| invoked_by | both |
| user_invocable | true |
| tools | ["Read","Bash","Glob","Grep"] |
| agents | ["planner","architect","developer","master-orchestrator"] |
| category | Validation & Quality |
| tags | ["project-health","onboarding","maturity","detection","routing"] |
| source | builtin |
| trust_score | 100 |
| provenance_sha | 2ecf6e7022656fd9 |
Detect the maturity stage of a software project by analyzing its file structure, configuration files, documentation, and test coverage. Route to the appropriate onboarding or initialization workflow based on the detected stage.
Skill({ skill: 'project-stage-detection' });
Invoke when:
| Stage | Description | Indicators |
|---|---|---|
new | Freshly initialized, no meaningful content | Only boilerplate files, no src/ |
early | Has core structure but missing key components | src/ exists, no tests or CI |
mid | Functional codebase, gaps in quality infrastructure | Tests exist, no CI/CD or sparse docs |
mature | Full-featured with CI/CD, tests, docs, linting | All quality gates present |
Command:
node .claude/skills/project-stage-detection/scripts/main.cjs --dir <project_root>
Expected output: JSON with stage, confidence, indicators, and recommendations.
Verify: Exit code 0 and valid JSON with a stage field.
The script checks for these indicators, scoring each:
| Indicator | Weight | Checked Path(s) |
|---|---|---|
| Source directory exists |
| HIGH |
src/, lib/, app/ |
| Tests exist | HIGH | tests/, test/, spec/, __tests__/ |
| CI/CD pipeline configured | HIGH | .github/workflows/, .gitlab-ci.yml |
| Package.json / pyproject.toml | MED | package.json, pyproject.toml |
| README exists and non-trivial | MED | README.md (>500 bytes) |
| Linting configured | MED | .eslintrc*, .ruff.toml, pylintrc |
| Documentation directory | LOW | docs/, .claude/docs/ |
| Changelog present | LOW | CHANGELOG.md, CHANGELOG.rst |
| Dependencies locked | LOW | package-lock.json, pnpm-lock.yaml |
| Score Range | Stage |
|---|---|
| 0–2 | new |
| 3–5 | early |
| 6–7 | mid |
| 8–9 | mature |
Command to verify score:
node .claude/skills/project-stage-detection/scripts/main.cjs --dir . --json | node -e "const d=require('fs').readFileSync('/dev/stdin','utf8');const r=JSON.parse(d);console.log('Stage:',r.stage,'Score:',r.score,'Confidence:',r.confidence)"
Based on the detected stage:
| Stage | Recommended Action |
|---|---|
new | Invoke project-onboarding skill to bootstrap |
early | Invoke gap-detection to find missing infrastructure |
mid | Invoke gap-detection then proactive-audit |
mature | Invoke gap-detection as health check only |
Routing command:
// After detection
if (result.stage === 'new') {
Skill({ skill: 'project-onboarding' });
} else {
Skill({ skill: 'gap-detection' });
}
Output location: .claude/context/reports/backend/project-stage-report-YYYY-MM-DD.md
Report format:
# Project Stage Detection Report
**Date:** {{date}}
**Project:** {{project_root}}
**Detected Stage:** {{stage}}
**Confidence:** {{confidence}}%
## Evidence
{{indicators_table}}
## Recommendations
{{recommendations_list}}
See schemas/output.schema.json for the full structured output contract.
Input validated against schemas/input.schema.json before execution.
Output contract defined in schemas/output.schema.json.
planner — uses on task start to calibrate workflow complexityarchitect — uses for brownfield assessment before redesigndeveloper — uses to determine onboarding steps for new reposmaster-orchestrator — uses to route to correct initialization workflowBefore starting:
Read .claude/context/memory/learnings.md for any previously detected stage for this project. If the stage was recently detected (within 7 days), skip re-detection and use cached result.
After completing:
Append to .claude/context/memory/learnings.md:
## Project Stage Detection — {{date}}
- Project: {{project_root}}
- Stage: {{stage}} (confidence: {{confidence}}%)
- Key gaps: {{gap_summary}}
- Recommended next action: {{next_action}}
mature for a project with no tests — tests are a required mature indicator..claude/ subdirectories — scan the project root only.existsSync checks.