Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions .changeset/unify-perstack-properties.md
Original file line number Diff line number Diff line change
@@ -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
18 changes: 13 additions & 5 deletions apps/create-expert/src/lib/agents-md-template.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
21 changes: 15 additions & 6 deletions apps/create-expert/src/lib/create-expert-toml.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down