Avyayalaya/pm-skills-arsenal / skills/specification-writing
specification-writing
VerifiedUse when writing a product spec, feature spec, API contract, agent task spec, or any other specification where a zero-question document is required. Encodes outcome-first methodology, acceptance criteria taxonomy, scope boundary protocol, executor context model, and ambiguity resolution framework.
| File | Kind | Size |
|---|---|---|
| FEEDBACK.md | markdown | 2.2 KB |
| SKILL.md | skill md | 121.0 KB |
| examples/USE_CASES.md | markdown | 60.9 KB |
FEEDBACK.md
View on GitHub# Feedback Log: specification-writing
> **Purpose:** Track real-world usage, capture what works and what doesn't, drive systematic skill improvement. Every use case should be logged here with rating and learnings.
---
## Use Case Log
### UC-001: [Brief Title] (YYYY-MM-DD)
**User:** [parth | team-member-name]
**Rating:** ?/10
**Scenario:** [1-2 sentences: what business problem, what prompt, what context]
**What Worked:**
- [Specific framework or output that delivered value]
- [Another thing that worked well]
**What Didn't:**
- [Gap, missing framework, wrong question addressed, etc.]
- [Another issue]
**Evidence Quality:**
- Input evidence: [T1/T2/T3/T4/T5/T6 breakdown of what was available]
- Output confidence: [H/M/L distribution in recommendations]
- [Did thin evidence produce thin output as expected, or did skill hallucinate?]
**Action Taken:**
- [What was changed in the skill file, if anything]
- [OR: Logged for pattern confirmation across more uses]
**Status:**
- [ ] Logged only
- [ ] Skill updated
- [ ] Waiting for pattern (needs 2+ similar cases)
---
### UC-002: [Next use case]
...
---
## Improvement Backlog
**Patterns requiring >=2 confirming cases before encoding:**
| Pattern | First Seen | Confirming Cases | Action When Validated |
|---|---|---|---|
| [e.g., "Too many frameworks for activation questions"] | UC-001 | 1/2 | Add routing logic to Context Fitness Check: activation questions → max 3 frameworks |
| [e.g., "Missing customer evidence tier"] | UC-003 | 1/2 | Add app store reviews/G2/forums as T2 evidence source in Evidence Standards section |
---
## Validated Improvements (Shipped)
| Improvement | Driven By | Version | Date |
|---|---|---|---|
| Context Gate added | UC from M365 Copilot Mobile analysis | v1.3.0 | 2026-02-19 |
| Reader Navigation + Notation Key | UC from M365 Copilot Mobile (7/10 rating: expert-only output) | v1.3.0 | 2026-02-19 |
---
## Usage Stats
| Month | Uses | Avg Rating | Top Issue |
|---|---|---|---|
| 2026-02 | 2 | 7.5/10 | Too many frameworks (2/2 cases) |
| 2026-03 | ? | ? | ? |
---
*Logging protocol: After every real-world use of this skill (by you or team), add a UC entry. Rate honestly. 7/10 with clear gaps is more useful than 9/10 with no learnings.*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |