@pcoliveira90/pdd 0.2.3 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pcoliveira90/pdd",
3
- "version": "0.2.3",
3
+ "version": "0.2.4",
4
4
  "description": "Patch-Driven Development CLI — safe, resilient and guided code changes",
5
5
  "type": "module",
6
6
  "bin": {
@@ -160,36 +160,155 @@ Execute Patch-Driven Development workflow.
160
160
  `
161
161
  },
162
162
  cursor: {
163
- '.cursor/pdd.prompt.md': `# PDD (Cursor)
163
+ '.cursor/rules/pdd.mdc': `---
164
+ description: PDD — Patch-Driven Development context for this repo (like Spec Kit project rules)
165
+ alwaysApply: true
166
+ ---
164
167
 
165
- You are helping run **Patch-Driven Development** in this repo. Prefer small, safe changes and evidence before edits.
168
+ # Patch-Driven Development
166
169
 
167
- ## Context to use
170
+ This repo uses **PDD**: safe changes in existing systems. The agent should:
168
171
 
169
- - Project rules: \`.pdd/constitution.md\`
170
- - Command playbooks: \`.pdd/commands/\` (e.g. \`pdd-fix.md\`, \`pdd-verify.md\`)
171
- - Templates: \`.pdd/templates/\` (delta-spec, patch-plan, verification-report)
172
+ - Read \`.pdd/constitution.md\` before substantive edits.
173
+ - Prefer **minimal safe deltas**; avoid drive-by refactors.
174
+ - Use templates under \`.pdd/templates/\` when producing specs or reports (\`delta-spec\`, \`patch-plan\`, \`verification-report\`).
175
+ - Follow playbooks under \`.pdd/commands/\` when the user invokes a PDD slash command.
172
176
 
173
- ## Workflow (high level)
177
+ Slash commands live in \`.cursor/commands/\` (type \`/\` in Chat/Agent). They mirror the PDD playbooks.
178
+ `,
179
+ '.cursor/commands/pdd.md': `---
180
+ description: "PDD — main workflow (Patch-Driven Development)"
181
+ argument-hint: "[issue or goal]"
182
+ ---
183
+
184
+ # PDD — main workflow
185
+
186
+ You are running **Patch-Driven Development** in this repository.
187
+
188
+ ## Ground rules
189
+
190
+ - Obey \`.pdd/constitution.md\`.
191
+ - Evidence before edits: locate behavior in code/tests before changing.
192
+ - Smallest change that solves the problem; match local patterns.
193
+
194
+ ## User request
195
+
196
+ $ARGUMENTS
197
+
198
+ (If empty, ask what issue or goal to work on.)
199
+
200
+ ## What to do
201
+
202
+ 1. Classify: bugfix vs feature vs exploration-only (**recon**).
203
+ 2. Name impacted files and risks.
204
+ 3. Propose a minimal plan, then implement or outline next steps.
205
+ 4. Say how to verify (tests, manual steps).
206
+
207
+ ## Output
208
+
209
+ - Files touched or to touch
210
+ - Risks and what you did not change on purpose
211
+ `,
212
+ '.cursor/commands/pdd-recon.md': `---
213
+ description: "PDD — recon (explore before editing)"
214
+ argument-hint: "[area or question]"
215
+ ---
216
+
217
+ # PDD — recon
218
+
219
+ **Exploration only** unless the user asks to edit.
220
+
221
+ ## Goal
222
+
223
+ Map the relevant part of the system before any change. Align with \`.pdd/commands/pdd-recon.md\`.
224
+
225
+ ## User focus
226
+
227
+ $ARGUMENTS
228
+
229
+ ## Deliver
230
+
231
+ - Short map: entry points, key modules, data flow if useful
232
+ - List of files worth reading next
233
+ - Risks and unknowns
234
+ - No production edits unless the user explicitly asked to fix something
235
+ `,
236
+ '.cursor/commands/pdd-fix.md': `---
237
+ description: "PDD — fix (minimal bugfix)"
238
+ argument-hint: "[bug description]"
239
+ ---
240
+
241
+ # PDD — fix
174
242
 
175
- 1. **Recon** map relevant files and risks; do not edit yet.
176
- 2. **Delta** — describe the minimal change (align with \`delta-spec\` / \`patch-plan\` ideas).
177
- 3. **Implement** — smallest diff that fixes the issue; match existing patterns.
178
- 4. **Verify** — how to confirm behavior; note regressions avoided or checked.
179
- 5. **Artifacts** — if the project uses \`changes/\` or PR notes, keep them consistent.
243
+ Fix a **bug** with a minimal safe delta. Align with \`.pdd/commands/pdd-fix.md\`.
180
244
 
181
- ## Issue to address
245
+ ## Issue
182
246
 
183
- Describe the issue or paste it here:
247
+ $ARGUMENTS
248
+
249
+ ## Steps
250
+
251
+ 1. Reproduce or infer current vs expected behavior (code/tests).
252
+ 2. Confirm root cause (not only symptoms).
253
+ 3. Apply the smallest fix; avoid scope creep.
254
+ 4. State how to verify (tests or manual).
255
+
256
+ ## Output
257
+
258
+ - Root cause (brief)
259
+ - Files changed
260
+ - Verification steps
261
+ `,
262
+ '.cursor/commands/pdd-feature.md': `---
263
+ description: "PDD — feature (safe extension)"
264
+ argument-hint: "[feature request]"
265
+ ---
266
+
267
+ # PDD — feature
268
+
269
+ Add behavior **safely** in an existing system. Align with \`.pdd/commands/pdd-feature.md\`.
270
+
271
+ ## Request
272
+
273
+ $ARGUMENTS
274
+
275
+ ## Steps
276
+
277
+ 1. Understand current behavior and extension points.
278
+ 2. Define the smallest extension (APIs, files).
279
+ 3. Implement without breaking existing callers.
280
+ 4. Verification and rollback idea.
281
+
282
+ ## Output
283
+
284
+ - Design note (what you extended and why)
285
+ - Files changed
286
+ - Tests or checks to run
287
+ `,
288
+ '.cursor/commands/pdd-verify.md': `---
289
+ description: "PDD — verify (validation checklist)"
290
+ argument-hint: "[scope or PR]"
291
+ ---
292
+
293
+ # PDD — verify
294
+
295
+ Validate a change or the current state. Align with \`.pdd/commands/pdd-verify.md\`.
296
+
297
+ ## Scope
298
+
299
+ $ARGUMENTS
300
+
301
+ ## Checklist
184
302
 
185
- \`\`\`
186
- {{issue}}
187
- \`\`\`
303
+ - Tests run (which)
304
+ - Regressions considered
305
+ - Manual checks if needed
306
+ - Residual risks
188
307
 
189
308
  ## Output
190
309
 
191
- - Clear list of files touched and why
192
- - If something is unknown, say what you would verify next (command, test, or manual step)
310
+ - Pass/fail summary
311
+ - What you would still verify before merge
193
312
  `
194
313
  },
195
314
  copilot: {