Skip to content

Avyayalaya/pm-skills-arsenal / skills/specification-writing

specification-writing

Verified

Use 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.

FileKindSize
FEEDBACK.mdmarkdown2.2 KB
SKILL.mdskill md121.0 KB
examples/USE_CASES.mdmarkdown60.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.*
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall