Comprehensive project context detection and state awareness.
Analyzes project context to determine current phase, team composition, and recommend next actions.
/plugin marketplace add jmagly/aiwg/plugin install utils@aiwgThis skill inherits all available tools. When active, it can use any tool Claude has access to.
references/phase-guide.mdscripts/project_awareness.pyscripts/status_check.pyComprehensive project context detection and state awareness.
This skill provides rich project context awareness including:
When triggered, this skill:
Detects project type:
Identifies AIWG state:
Parses team configuration:
.aiwg/team/Loads recent activity:
Builds context object:
| Natural Language | Action |
|---|---|
| "Where are we?" | Check phase status, recent activity |
| "What's next?" | Identify pending tasks, next milestone |
| "Project status" | Full status report |
| "Current phase" | Phase name + completion percentage |
| "Ready to transition?" | Gate criteria check |
| "What's blocking us?" | Risk register + blockers |
| "How long until..." | Milestone progress estimate |
| "Who owns..." | Team and agent assignments |
.aiwg/planning/phase-status.md - Current phase and progress.aiwg/planning/iteration-plan.md - Current iteration tasks.aiwg/gates/ - Gate criteria and validation status.aiwg/risks/risk-register.md - Active risks and blockers.aiwg/team/agent-assignments.md - Who's working on what.aiwg/requirements/ - Requirements completion status.aiwg/architecture/ - Architecture baseline statusCLAUDE.md - Project configuration.aiwg/intake/project-intake.md - Original project scope{
"project": {
"name": "my-project",
"type": "application",
"subtype": "web-api",
"root": "/path/to/project",
"description": "From package.json or README"
},
"tech_stack": {
"languages": ["typescript", "python"],
"runtime": "node",
"framework": "express",
"package_manager": "npm",
"database": "postgresql",
"testing": "vitest",
"ci_cd": "github-actions"
},
"aiwg": {
"installed": true,
"frameworks": ["sdlc-complete"],
"addons": ["aiwg-utils", "voice-framework"],
"phase": "elaboration",
"iteration": 3,
"agents_deployed": 45,
"commands_deployed": 38
},
"team": {
"members": [
{"name": "John", "role": "tech-lead", "agent": "architecture-designer"}
],
"agent_assignments": {
"architecture-designer": "John",
"test-architect": "Jane"
}
},
"activity": {
"current_branch": "feature/user-auth",
"recent_commits": [...],
"open_prs": [...],
"modified_artifacts": [...],
"last_gate_check": "2025-12-05"
},
"artifacts": {
"total": 24,
"by_status": {
"draft": 5,
"review": 3,
"baselined": 16
},
"recent": [...]
},
"recommendations": [
"Complete SAD review (2 reviewers pending)",
"Run gate-check for Elaboration exit",
"Update risk register (7 days stale)"
]
}
Phase: [Current Phase] ([X]% complete)
Iteration: [N] of [Total]
Next Milestone: [Milestone Name] - [Date/Status]
Blockers: [Count] ([List if < 3])
## Project: [Name]
Phase: [Phase] | Iteration: [N]
Started: [Date] | Target: [Date]
### Completion
- Requirements: [X]%
- Architecture: [X]%
- Implementation: [X]%
- Testing: [X]%
### Active Work
- [Task 1] - [Owner] - [Status]
- [Task 2] - [Owner] - [Status]
### Blockers/Risks
- [Risk 1] - [Severity] - [Mitigation]
### Next Steps
1. [Action 1]
2. [Action 2]
| Indicator | Project Type |
|---|---|
| package.json + src/index.ts | Node.js application |
| package.json + lib/ | Node.js library |
| setup.py or pyproject.toml | Python package |
| Cargo.toml | Rust project |
| go.mod | Go module |
| pom.xml | Java Maven project |
| turbo.json or lerna.json | Monorepo |
| Files | Framework |
|---|---|
| next.config.js | Next.js |
| angular.json | Angular |
| vite.config.ts | Vite |
| django, manage.py | Django |
| express in package.json | Express |
| fastapi in requirements | FastAPI |
| Location | Information |
|---|---|
| .aiwg/ | AIWG artifacts directory exists |
| .aiwg/config/registry.json | Installed frameworks |
| .aiwg/planning/phase-plan-*.md | Current phase |
| .aiwg/planning/iteration-*.md | Current iteration |
| .claude/agents/ | Deployed agents |
| .claude/commands/ | Deployed commands |
| Artifacts Present | Likely Phase |
|---|---|
| intake/ only | Concept/Inception |
| requirements/ + architecture/ draft | Inception |
| architecture/ baselined | Elaboration |
| testing/ + deployment/ draft | Construction |
| deployment/ baselined | Transition |
| All baselined + production logs | Production |
| Phase | Description | Key Artifacts |
|---|---|---|
| Inception | Vision, risks, feasibility | intake forms, business case |
| Elaboration | Architecture baseline | SAD, ADRs, test strategy |
| Construction | Feature implementation | code, tests, reviews |
| Transition | Deployment, handover | runbooks, training |
| Production | Operations, iteration | monitoring, incidents |
This skill may trigger these commands based on context:
| Context | Command |
|---|---|
| User wants full report | /project-status |
| User asks about health | /project-health-check |
| User asks about gate readiness | /flow-gate-check [phase] |
| User seems lost on next steps | Suggest relevant flow command |
Model auto-invokes project-awareness
Returns:
"Project: MyAPI (Node.js/Express API)
Phase: Elaboration (Iteration 3)
Team: 4 members assigned
Recent: SAD approved, Test Plan in review
Recommendations:
- Complete Test Plan review
- Begin Construction planning"
User: "What phase are we in?"
Skill returns:
"Current Phase: Elaboration
Milestone: Architecture Baseline (ABM)
Progress: 75% complete
Completed:
✓ Requirements baseline
✓ SAD approved
✓ 3/5 ADRs written
Remaining:
- Test Plan approval
- Risk register update
- Gate check"
User: "Who owns the architecture?"
Skill returns:
"Architecture ownership:
- Lead: John (architecture-designer)
- Reviewers: Jane (security-architect), Bob (test-architect)
Recent activity:
- SAD v1.2 updated 2 days ago
- ADR-005 created yesterday"
# Full context dump
python project_awareness.py --full
# Specific aspects
python project_awareness.py --tech-stack
python project_awareness.py --aiwg-state
python project_awareness.py --team
python project_awareness.py --activity
# JSON output
python project_awareness.py --full --json
# Recommendations only
python project_awareness.py --recommendations
This skill provides context for:
artifact-orchestration: Knows current phase for artifact selectiongate-evaluation: Knows what gate to checkparallel-dispatch: Knows which agents are relevanttemplate-engine: Knows project name, type for templatesContext is cached for performance:
Cache location: .aiwg/working/context-cache.json
.aiwg/team/.aiwg/planning/.aiwg/config/registry.json.aiwg/reports/artifact-index.jsonSearch, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.