Comprehensive project context detection and state awareness.
Detects project context, technology stack, team configuration, and current phase status.
/plugin marketplace add jmagly/ai-writing-guide/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.jsonCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.