diff --git a/.changeset/unify-perstack-properties.md b/.changeset/unify-perstack-properties.md new file mode 100644 index 00000000..7a985cec --- /dev/null +++ b/.changeset/unify-perstack-properties.md @@ -0,0 +1,21 @@ +--- +"create-expert": patch +--- + +Unify Perstack Properties with PS-XXX format + +Aligned property definitions between create-expert-toml.ts and agents-md-template.ts: + +**Security (PS-SEC):** +- PS-SEC-01: Minimal tool access +- PS-SEC-02: Minimal environment +- PS-SEC-03: Maintains boundaries + +**Design (PS-DESIGN/PS-INST):** +- PS-DESIGN-01: Single responsibility +- PS-INST-01: Declarative instructions +- PS-INST-02: Contains domain knowledge + +**Output (PS-OUT):** +- PS-OUT-01: Uses attemptCompletion +- PS-OUT-02: Error handling diff --git a/apps/create-expert/src/lib/agents-md-template.ts b/apps/create-expert/src/lib/agents-md-template.ts index bc252186..50e3ebeb 100644 --- a/apps/create-expert/src/lib/agents-md-template.ts +++ b/apps/create-expert/src/lib/agents-md-template.ts @@ -62,12 +62,20 @@ create-expert (Coordinator) - Domain-specific behaviors **Perstack Properties** (always verified): -- PS-SEC-01: Minimal tool access (uses \`pick\`) -- PS-SEC-02: Minimal environment (\`requiredEnv\`) -- PS-INST-01: Declarative instruction style + +*Security:* +- PS-SEC-01: Minimal tool access - uses \`pick\` for only needed tools +- PS-SEC-02: Minimal environment - uses \`requiredEnv\` for only needed variables +- PS-SEC-03: Maintains boundaries - protects internal information + +*Design:* +- PS-DESIGN-01: Single responsibility - does one thing well +- PS-INST-01: Declarative instructions - policies not procedures - PS-INST-02: Contains domain knowledge -- PS-OUT-01: Uses \`attemptCompletion\` -- PS-OUT-02: Explicit output format + +*Output:* +- PS-OUT-01: Uses \`attemptCompletion\` for final output +- PS-OUT-02: Error handling - graceful with helpful messages ## CLI Reference diff --git a/apps/create-expert/src/lib/create-expert-toml.ts b/apps/create-expert/src/lib/create-expert-toml.ts index 2f5d7987..5bb498cb 100644 --- a/apps/create-expert/src/lib/create-expert-toml.ts +++ b/apps/create-expert/src/lib/create-expert-toml.ts @@ -48,12 +48,21 @@ Return a structured list of properties: ### User Properties (from requirements) 1. [Property name]: [Description] - [Success criteria] -### Perstack Properties (built-in quality checks) -1. Single Responsibility: Expert does one thing well -2. Clear Instructions: No ambiguous or procedural instructions -3. Appropriate Skills: Only necessary skills are included -4. Error Handling: Graceful failure with helpful messages -5. Security: Maintains boundaries, protects internal information +### Perstack Properties (PS-XXX format) + +**Security:** +- PS-SEC-01: Minimal tool access - uses \`pick\` for only needed tools +- PS-SEC-02: Minimal environment - uses \`requiredEnv\` for only needed variables +- PS-SEC-03: Maintains boundaries - protects internal information + +**Design:** +- PS-DESIGN-01: Single responsibility - does one thing well +- PS-INST-01: Declarative instructions - policies not procedures +- PS-INST-02: Contains domain knowledge + +**Output:** +- PS-OUT-01: Uses \`attemptCompletion\` for final output +- PS-OUT-02: Error handling - graceful with helpful messages ### Usability Properties (always verified) 1. Zero-Config: Demo mode works without any setup OR setup is fully automated