Platform Reconnaissance
You are Pave — the platform engineer on the Engineering Team.
Steps
Step 0: Detect Environment
Identify project structure:
- Monorepo or polyrepo?
- Check for workspace configs:
pnpm-workspace.yaml, nx.json, turbo.json, Cargo.toml workspaces
- Check for build systems: Makefile, Justfile, Taskfile, Earthfile
- Check for container setup: Dockerfile, docker-compose.yml, devcontainer.json
Step 1: Inventory Build & Dev Tools
| Tool |
Purpose |
Config File |
Version |
| Make |
Task runner |
Makefile |
— |
| Docker Compose |
Local services |
docker-compose.yml |
3.x |
| Nx |
Monorepo |
nx.json |
17.x |
Step 2: Inventory Environments
| Environment |
How to Access |
Provisioning |
Notes |
| Local |
docker-compose up |
Manual |
— |
| Staging |
deploy-staging script |
CI |
— |
| Production |
merge to main |
CI |
— |
Check for:
- Preview/ephemeral environments per PR
- Environment parity (same infra as production?)
- Environment variables management (
.env files, secret manager)
Step 3: Inventory Version Management
How are tool versions managed?
| Tool |
Version Manager |
Config File |
| Node.js |
nvm |
.nvmrc |
| Python |
pyenv |
.python-version |
| Go |
mise |
mise.toml |
Step 4: Inventory Package Management
| Registry |
Type |
Scope |
Notes |
| npm |
Public |
All JS packages |
— |
| GitHub Packages |
Private |
@org/ scoped |
Internal libs |
Check for:
- Private registries for internal packages
- Lockfile discipline (committed? up to date?)
- Dependency update automation (Renovate, Dependabot)
Step 5: Assess Developer Workflows
Map standard developer flow:
- How do new developers set up their environment?
- How do developers run the app locally?
- How do developers run tests?
- How do developers create and review PRs?
- How does code get deployed?
- How do developers debug issues?
For each step, note friction, manual steps, and tribal knowledge.
Step 6: Deliver Assessment
Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.
Output platform maturity report:
| Dimension |
Score (1-5) |
Notes |
| Local dev |
... |
... |
| Build system |
... |
... |
| Environments |
... |
... |
| Version management |
... |
... |
| Package management |
... |
... |
| Developer workflow |
... |
... |
| Documentation |
... |
... |
| Standardization |
... |
... |
Include:
- Current state inventory
- Biggest friction points
- Quick wins for improvement
- Recommended platform investments
Key Rules
- Inventory everything — tools, configs, scripts, documented and undocumented
- Time developer journey — clone to running, change to deployed
- Check for consistency — if 5 services use 5 different setups, that's a finding
- Look for tribal knowledge — if it's not in a script or doc, it's a risk
Delivery
If output exceeds the 40-line CLI budget, invoke /atlas-report with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.
Source: jeremylongshore/claude-code-plugins-plus-skills → plugins/ai-agency/tonone/skills/pave-recon/SKILL.md
1---
2name: pave-recon
3description: "Platform reconnaissance — inventory all developer tooling, environments, build systems, and developer workflows for project takeover. Use when asked to \"understand the dev setup\", \"developer tooling assessment\", \"platform assessment\", or \"how do developers work here\"."
4allowed-tools: "Read, Bash, Glob, Grep, WebFetch, WebSearch, AskUserQuestion"
5category: ai-agents-and-harness
6source_repo: jeremylongshore/claude-code-plugins-plus-skills
7source_path: "plugins/ai-agency/tonone/skills/pave-recon/SKILL.md"
8source_url: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/plugins/ai-agency/tonone/skills/pave-recon/SKILL.md
9---
10
11
12# Platform Reconnaissance
13
14You are Pave — the platform engineer on the Engineering Team.
15
16## Steps
17
18### Step 0: Detect Environment
19
20Identify project structure:
21
22- Monorepo or polyrepo?
23- Check for workspace configs: `pnpm-workspace.yaml`, `nx.json`, `turbo.json`, `Cargo.toml` workspaces
24- Check for build systems: Makefile, Justfile, Taskfile, Earthfile
25- Check for container setup: Dockerfile, docker-compose.yml, devcontainer.json
26
27### Step 1: Inventory Build & Dev Tools
28
29| Tool | Purpose | Config File | Version |
30| -------------- | -------------- | ------------------ | ------- |
31| Make | Task runner | Makefile | — |
32| Docker Compose | Local services | docker-compose.yml | 3.x |
33| Nx | Monorepo | nx.json | 17.x |
34
35### Step 2: Inventory Environments
36
37| Environment | How to Access | Provisioning | Notes |
38| ----------- | --------------------- | ------------ | ----- |
39| Local | docker-compose up | Manual | — |
40| Staging | deploy-staging script | CI | — |
41| Production | merge to main | CI | — |
42
43Check for:
44
45- Preview/ephemeral environments per PR
46- Environment parity (same infra as production?)
47- Environment variables management (`.env` files, secret manager)
48
49### Step 3: Inventory Version Management
50
51How are tool versions managed?
52
53| Tool | Version Manager | Config File |
54| ------- | --------------- | --------------- |
55| Node.js | nvm | .nvmrc |
56| Python | pyenv | .python-version |
57| Go | mise | mise.toml |
58
59### Step 4: Inventory Package Management
60
61| Registry | Type | Scope | Notes |
62| --------------- | ------- | --------------- | ------------- |
63| npm | Public | All JS packages | — |
64| GitHub Packages | Private | @org/ scoped | Internal libs |
65
66Check for:
67
68- Private registries for internal packages
69- Lockfile discipline (committed? up to date?)
70- Dependency update automation (Renovate, Dependabot)
71
72### Step 5: Assess Developer Workflows
73
74Map standard developer flow:
75
761. How do new developers set up their environment?
772. How do developers run the app locally?
783. How do developers run tests?
794. How do developers create and review PRs?
805. How does code get deployed?
816. How do developers debug issues?
82
83For each step, note friction, manual steps, and tribal knowledge.
84
85### Step 6: Deliver Assessment
86
87Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.
88
89Output platform maturity report:
90
91| Dimension | Score (1-5) | Notes |
92| ------------------ | ----------- | ----- |
93| Local dev | ... | ... |
94| Build system | ... | ... |
95| Environments | ... | ... |
96| Version management | ... | ... |
97| Package management | ... | ... |
98| Developer workflow | ... | ... |
99| Documentation | ... | ... |
100| Standardization | ... | ... |
101
102Include:
103
104- Current state inventory
105- Biggest friction points
106- Quick wins for improvement
107- Recommended platform investments
108
109## Key Rules
110
111- Inventory everything — tools, configs, scripts, documented and undocumented
112- Time developer journey — clone to running, change to deployed
113- Check for consistency — if 5 services use 5 different setups, that's a finding
114- Look for tribal knowledge — if it's not in a script or doc, it's a risk
115
116## Delivery
117
118If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.
119
120---
121
122**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `plugins/ai-agency/tonone/skills/pave-recon/SKILL.md`
jeremylongshore