42 lines
1.9 KiB
Markdown
42 lines
1.9 KiB
Markdown
---
|
|
name: resource-discovery-config
|
|
description: pi-crew resource and configuration discovery workflow. Use when changing agents, teams, workflows, skills, resource hooks, config precedence, or project/user overrides.
|
|
---
|
|
|
|
# resource-discovery-config
|
|
|
|
Use this skill for pi-crew resource/config work.
|
|
|
|
## Source patterns distilled
|
|
|
|
- Pi resource loader: `source/pi-mono/packages/coding-agent/src/core/resource-loader.ts`, extension `resources_discover` hook
|
|
- pi-crew discovery: `src/agents/discover-agents.ts`, `src/teams/discover-teams.ts`, `src/workflows/discover-workflows.ts`
|
|
- Config: `src/config/config.ts`, `src/schema/config-schema.ts`, `schema.json`, `docs/resource-formats.md`
|
|
|
|
## Rules
|
|
|
|
- Respect discovery precedence: project resources should override user/builtin where supported.
|
|
- Keep built-in resource formats stable and documented.
|
|
- Project config (`.pi/pi-crew.json`) must be sanitized: do not allow dangerous user-only settings such as agent override injection if project trust is lower.
|
|
- Resource paths exposed through Pi hooks must point to package-root resources after build; verify `__dirname` resolution carefully.
|
|
- Avoid dynamic inline imports; keep discovery synchronous or async according to call-site expectations.
|
|
- Validate config with schema and provide actionable errors.
|
|
- When adding new config fields, update defaults, schema, docs, tests, and examples together.
|
|
|
|
## Anti-patterns
|
|
|
|
- Resolving package skills to `src/skills` instead of package-root `skills` after publishing.
|
|
- Letting project-local config inject arbitrary global agent overrides.
|
|
- Introducing precedence ambiguity between project/user/builtin resources.
|
|
- Changing resource file syntax without migration notes.
|
|
|
|
## Verification
|
|
|
|
```bash
|
|
cd pi-crew
|
|
npx tsc --noEmit
|
|
node --experimental-strip-types --test test/unit/config-schema-validation.test.ts test/unit/config.test.ts test/unit/extension-api-surface.test.ts test/unit/agent-override-skills.test.ts
|
|
npm test
|
|
npm pack --dry-run
|
|
```
|