@makerkit/prd 0.0.2 → 0.0.3
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/index.d.ts +32 -32
- package/index.js +3 -2
- package/index.mjs +3 -2
- package/mcp.d.ts +1 -1
- package/mcp.js +6 -7
- package/mcp.mjs +6 -7
- package/node.d.ts +1 -1
- package/package.json +1 -1
- package/{prd.service-DSBp8sMl.d.ts → prd.service-x5EpOoMv.d.ts} +5 -0
- package/{prompts-B0ciGmv-.mjs → prompts-B0VejF7q.mjs} +8 -6
- package/{prompts-CTRnq1J5.js → prompts-DJQ4FQ11.js} +8 -6
package/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as DeletePrdOutputSchema, $t as ResolveOpenQuestionOutput, A as AssignStoryToPhaseOutput, An as DecisionLogEntry, At as ListPrdsOutputSchema, B as CreatePrdInputSchema, Bn as StoryTraceabilityMap, Bt as PhasesOutputSchema, C as AddStoryLogOutputSchema, Cn as UpdateUserStoryInputSchema, Ct as GetProjectStatusOutputSchema, D as AddUserStoryOutputSchema, Dn as Attachment, Dt as GetStoryOutputSchema, E as AddUserStoryOutput, En as AgentTaskPacket, Et as GetStoryOutput, F as CreateCustomPhaseInput, Fn as RiskItem, Ft as MarkNotApplicableInputSchema, G as DecideEdgeCaseInputSchema, Gt as RemoveAttachmentInput, H as CreatePrdOutputSchema, Hn as StructuredPRD, Ht as PrdSectionValueSchemas, I as CreateCustomPhaseInputSchema, In as StoryComplexity, It as MarkNotApplicableOutput, J as DeletePhaseInput, Jt as RemoveAttachmentOutputSchema, K as DecideEdgeCaseOutput, Kt as RemoveAttachmentInputSchema, L as CreateCustomPhaseOutput, Ln as StoryLogEntry, Lt as MarkNotApplicableOutputSchema, M as CheckPlanInputSchema, Mn as GlossaryTerm, Mt as ListTemplatesOutput, N as CheckPlanOutput, Nn as NotApplicableTopic, Nt as ListTemplatesOutputSchema, O as AssignStoryToPhaseInput, On as CrossDependency, Ot as ListPrdsInputSchema, P as CheckPlanOutputSchema, Pn as OpenQuestion, Pt as MarkNotApplicableInput, Q as DeletePrdOutput, Qt as ResolveOpenQuestionInputSchema, R as CreateCustomPhaseOutputSchema, Rn as StoryPriority, Rt as NotApplicableTopicSchema, S as AddStoryLogOutput, Sn as UpdateUserStoryInput, St as GetProjectStatusOutput, T as AddUserStoryInputSchema, Tn as UpdateUserStoryOutputSchema, Tt as GetStoryInputSchema, U as CustomPhaseSchema, Un as UserStory, Ut as PrdSummary, V as CreatePrdOutput, Vn as StoryVerification, Vt as PrdSection, W as DecideEdgeCaseInput, Wt as PrdSummarySchema, X as DeletePrdInput, Xt as ReorderPhasesInputSchema, Y as DeletePhaseInputSchema, Yt as ReorderPhasesInput, Z as DeletePrdInputSchema, Zt as ResolveOpenQuestionInput, _ as AddGlossaryTermInputSchema, _n as UpdatePrdSectionOutputSchema, _t as GetPrdInput, a as PrdVerificationResult, an as StoryPrioritySchema, at as ExportPrdMarkdownInputSchema, b as AddStoryLogInput, bn as UpdateStoryStatusOutput, bt as GetPrdOutputSchema, c as AddAttachmentInput, cn as UpdateAttachmentInput, ct as GetImplementationPromptsInputSchema, d as AddAttachmentOutputSchema, dn as UpdateAttachmentOutputSchema, dt as GetImprovementSuggestionsInputSchema, en as ResolveOpenQuestionOutputSchema, et as DeleteUserStoryInput, f as AddDecisionInput, fn as UpdatePhaseInput, ft as GetImprovementSuggestionsOutput, g as AddGlossaryTermInput, gn as UpdatePrdSectionOutput, gt as GetNextStoryOutputSchema, h as AddDecisionOutputSchema, hn as UpdatePrdSectionInputSchema, ht as GetNextStoryOutput, i as PrdVerificationDiagnostic, in as StoryLogEntrySchema, it as ExportPrdMarkdownInput, j as AssignStoryToPhaseOutputSchema, jn as EdgeCase, jt as ListTemplatesInputSchema, k as AssignStoryToPhaseInputSchema, kn as CustomPhase, kt as ListPrdsOutput, l as AddAttachmentInputSchema, ln as UpdateAttachmentInputSchema, lt as GetImplementationPromptsOutput, m as AddDecisionOutput, mn as UpdatePrdSectionInput, mt as GetNextStoryInputSchema, n as PrdRevisionConflictError, nn as StoryAttachmentSchema, nt as DeleteUserStoryOutput, o as createPrdService, on as StoryStatusSchema, ot as ExportPrdMarkdownOutput, p as AddDecisionInputSchema, pn as UpdatePhaseInputSchema, pt as GetImprovementSuggestionsOutputSchema, q as DecideEdgeCaseOutputSchema, qt as RemoveAttachmentOutput, r as PrdService, rn as StoryComplexitySchema, rt as DeleteUserStoryOutputSchema, s as normalizePrd, sn as StoryVerificationSchema, st as ExportPrdMarkdownOutputSchema, t as PrdDeps, tn as StoryAttachment, tt as DeleteUserStoryInputSchema, u as AddAttachmentOutput, un as UpdateAttachmentOutput, ut as GetImplementationPromptsOutputSchema, v as AddGlossaryTermOutput, vn as UpdateStoryStatusInput, vt as GetPrdInputSchema, w as AddUserStoryInput, wn as UpdateUserStoryOutput, wt as GetStoryInput, x as AddStoryLogInputSchema, xn as UpdateStoryStatusOutputSchema, xt as GetProjectStatusInputSchema, y as AddGlossaryTermOutputSchema, yn as UpdateStoryStatusInputSchema, yt as GetPrdOutput, z as CreatePrdInput, zn as StoryStatus, zt as PhasesOutput } from "./prd.service-
|
|
1
|
+
import { $ as DeletePrdOutputSchema, $t as ResolveOpenQuestionOutput, A as AssignStoryToPhaseOutput, An as DecisionLogEntry, At as ListPrdsOutputSchema, B as CreatePrdInputSchema, Bn as StoryTraceabilityMap, Bt as PhasesOutputSchema, C as AddStoryLogOutputSchema, Cn as UpdateUserStoryInputSchema, Ct as GetProjectStatusOutputSchema, D as AddUserStoryOutputSchema, Dn as Attachment, Dt as GetStoryOutputSchema, E as AddUserStoryOutput, En as AgentTaskPacket, Et as GetStoryOutput, F as CreateCustomPhaseInput, Fn as RiskItem, Ft as MarkNotApplicableInputSchema, G as DecideEdgeCaseInputSchema, Gt as RemoveAttachmentInput, H as CreatePrdOutputSchema, Hn as StructuredPRD, Ht as PrdSectionValueSchemas, I as CreateCustomPhaseInputSchema, In as StoryComplexity, It as MarkNotApplicableOutput, J as DeletePhaseInput, Jt as RemoveAttachmentOutputSchema, K as DecideEdgeCaseOutput, Kt as RemoveAttachmentInputSchema, L as CreateCustomPhaseOutput, Ln as StoryLogEntry, Lt as MarkNotApplicableOutputSchema, M as CheckPlanInputSchema, Mn as GlossaryTerm, Mt as ListTemplatesOutput, N as CheckPlanOutput, Nn as NotApplicableTopic, Nt as ListTemplatesOutputSchema, O as AssignStoryToPhaseInput, On as CrossDependency, Ot as ListPrdsInputSchema, P as CheckPlanOutputSchema, Pn as OpenQuestion, Pt as MarkNotApplicableInput, Q as DeletePrdOutput, Qt as ResolveOpenQuestionInputSchema, R as CreateCustomPhaseOutputSchema, Rn as StoryPriority, Rt as NotApplicableTopicSchema, S as AddStoryLogOutput, Sn as UpdateUserStoryInput, St as GetProjectStatusOutput, T as AddUserStoryInputSchema, Tn as UpdateUserStoryOutputSchema, Tt as GetStoryInputSchema, U as CustomPhaseSchema, Un as UserStory, Ut as PrdSummary, V as CreatePrdOutput, Vn as StoryVerification, Vt as PrdSection, W as DecideEdgeCaseInput, Wt as PrdSummarySchema, X as DeletePrdInput, Xt as ReorderPhasesInputSchema, Y as DeletePhaseInputSchema, Yt as ReorderPhasesInput, Z as DeletePrdInputSchema, Zt as ResolveOpenQuestionInput, _ as AddGlossaryTermInputSchema, _n as UpdatePrdSectionOutputSchema, _t as GetPrdInput, a as PrdVerificationResult, an as StoryPrioritySchema, at as ExportPrdMarkdownInputSchema, b as AddStoryLogInput, bn as UpdateStoryStatusOutput, bt as GetPrdOutputSchema, c as AddAttachmentInput, cn as UpdateAttachmentInput, ct as GetImplementationPromptsInputSchema, d as AddAttachmentOutputSchema, dn as UpdateAttachmentOutputSchema, dt as GetImprovementSuggestionsInputSchema, en as ResolveOpenQuestionOutputSchema, et as DeleteUserStoryInput, f as AddDecisionInput, fn as UpdatePhaseInput, ft as GetImprovementSuggestionsOutput, g as AddGlossaryTermInput, gn as UpdatePrdSectionOutput, gt as GetNextStoryOutputSchema, h as AddDecisionOutputSchema, hn as UpdatePrdSectionInputSchema, ht as GetNextStoryOutput, i as PrdVerificationDiagnostic, in as StoryLogEntrySchema, it as ExportPrdMarkdownInput, j as AssignStoryToPhaseOutputSchema, jn as EdgeCase, jt as ListTemplatesInputSchema, k as AssignStoryToPhaseInputSchema, kn as CustomPhase, kt as ListPrdsOutput, l as AddAttachmentInputSchema, ln as UpdateAttachmentInputSchema, lt as GetImplementationPromptsOutput, m as AddDecisionOutput, mn as UpdatePrdSectionInput, mt as GetNextStoryInputSchema, n as PrdRevisionConflictError, nn as StoryAttachmentSchema, nt as DeleteUserStoryOutput, o as createPrdService, on as StoryStatusSchema, ot as ExportPrdMarkdownOutput, p as AddDecisionInputSchema, pn as UpdatePhaseInputSchema, pt as GetImprovementSuggestionsOutputSchema, q as DecideEdgeCaseOutputSchema, qt as RemoveAttachmentOutput, r as PrdService, rn as StoryComplexitySchema, rt as DeleteUserStoryOutputSchema, s as normalizePrd, sn as StoryVerificationSchema, st as ExportPrdMarkdownOutputSchema, t as PrdDeps, tn as StoryAttachment, tt as DeleteUserStoryInputSchema, u as AddAttachmentOutput, un as UpdateAttachmentOutput, ut as GetImplementationPromptsOutputSchema, v as AddGlossaryTermOutput, vn as UpdateStoryStatusInput, vt as GetPrdInputSchema, w as AddUserStoryInput, wn as UpdateUserStoryOutput, wt as GetStoryInput, x as AddStoryLogInputSchema, xn as UpdateStoryStatusOutputSchema, xt as GetProjectStatusInputSchema, y as AddGlossaryTermOutputSchema, yn as UpdateStoryStatusInputSchema, yt as GetPrdOutput, z as CreatePrdInput, zn as StoryStatus, zt as PhasesOutput } from "./prd.service-x5EpOoMv.js";
|
|
2
2
|
//#region src/prd-operations.d.ts
|
|
3
3
|
/**
|
|
4
4
|
* Pure PRD transforms.
|
|
@@ -164,42 +164,12 @@ export declare function isNotApplicable(prd: StructuredPRD, topic: NotApplicable
|
|
|
164
164
|
*/
|
|
165
165
|
export declare function formatPrdMarkdown(prd: StructuredPRD, filename?: string): string;
|
|
166
166
|
//#endregion
|
|
167
|
-
//#region src/templates.d.ts
|
|
168
|
-
/**
|
|
169
|
-
* Starting points for new PRDs. A template fills sections the author would
|
|
170
|
-
* otherwise start empty, and gives `shape_prd` extra questions that matter for
|
|
171
|
-
* that kind of work. Everything it adds can be edited or removed afterwards.
|
|
172
|
-
*/
|
|
173
|
-
interface PrdTemplate {
|
|
174
|
-
id: TemplateId;
|
|
175
|
-
name: string;
|
|
176
|
-
description: string;
|
|
177
|
-
/** Sentence an agent can use to pick the right template. */
|
|
178
|
-
whenToUse: string;
|
|
179
|
-
defaults: {
|
|
180
|
-
nonGoals?: string[];
|
|
181
|
-
outOfScope?: string[];
|
|
182
|
-
openQuestions?: string[];
|
|
183
|
-
globalAcceptanceCriteria?: string[];
|
|
184
|
-
qualityStandards?: string[];
|
|
185
|
-
technicalConstraints?: string[];
|
|
186
|
-
rolloutPhases?: string[];
|
|
187
|
-
rollbackConditions?: string[];
|
|
188
|
-
};
|
|
189
|
-
/** Extra questions for the shaping interview. */
|
|
190
|
-
interviewFocus: string[];
|
|
191
|
-
}
|
|
192
|
-
export declare const TEMPLATE_IDS: readonly ["saas-feature", "internal-tool", "integration", "mvp"];
|
|
193
|
-
type TemplateId = (typeof TEMPLATE_IDS)[number];
|
|
194
|
-
export declare const PRD_TEMPLATES: readonly PrdTemplate[];
|
|
195
|
-
export declare function getTemplate(id: TemplateId): PrdTemplate;
|
|
196
|
-
//#endregion
|
|
197
167
|
//#region src/prompts.d.ts
|
|
198
168
|
/**
|
|
199
169
|
* The instructions behind the MCP prompts, exported so other tools (e.g. a
|
|
200
170
|
* UI that shows what to ask the agent) give exactly the same text.
|
|
201
171
|
*/
|
|
202
|
-
export declare function shapePrdPrompt(
|
|
172
|
+
export declare function shapePrdPrompt(overview?: string, filename?: string): string;
|
|
203
173
|
export declare function architectPrdPrompt(filename: string): string;
|
|
204
174
|
export declare function reviewStoryPrompt(filename: string, storyId: string, base?: string): string;
|
|
205
175
|
export declare function implementStoryPrompt(filename: string, storyId?: string): string;
|
|
@@ -225,4 +195,34 @@ export declare function checkPlan(prd: StructuredPRD): {
|
|
|
225
195
|
items: PlanCheckItem[];
|
|
226
196
|
};
|
|
227
197
|
//#endregion
|
|
198
|
+
//#region src/templates.d.ts
|
|
199
|
+
/**
|
|
200
|
+
* Starting points for new PRDs. A template fills sections the author would
|
|
201
|
+
* otherwise start empty, and gives `shape_prd` extra questions that matter for
|
|
202
|
+
* that kind of work. Everything it adds can be edited or removed afterwards.
|
|
203
|
+
*/
|
|
204
|
+
interface PrdTemplate {
|
|
205
|
+
id: TemplateId;
|
|
206
|
+
name: string;
|
|
207
|
+
description: string;
|
|
208
|
+
/** Sentence an agent can use to pick the right template. */
|
|
209
|
+
whenToUse: string;
|
|
210
|
+
defaults: {
|
|
211
|
+
nonGoals?: string[];
|
|
212
|
+
outOfScope?: string[];
|
|
213
|
+
openQuestions?: string[];
|
|
214
|
+
globalAcceptanceCriteria?: string[];
|
|
215
|
+
qualityStandards?: string[];
|
|
216
|
+
technicalConstraints?: string[];
|
|
217
|
+
rolloutPhases?: string[];
|
|
218
|
+
rollbackConditions?: string[];
|
|
219
|
+
};
|
|
220
|
+
/** Extra questions for the shaping interview. */
|
|
221
|
+
interviewFocus: string[];
|
|
222
|
+
}
|
|
223
|
+
export declare const TEMPLATE_IDS: readonly ["saas-feature", "internal-tool", "integration", "mvp"];
|
|
224
|
+
type TemplateId = (typeof TEMPLATE_IDS)[number];
|
|
225
|
+
export declare const PRD_TEMPLATES: readonly PrdTemplate[];
|
|
226
|
+
export declare function getTemplate(id: TemplateId): PrdTemplate;
|
|
227
|
+
//#endregion
|
|
228
228
|
export { AddAttachmentInput, AddAttachmentInputSchema, AddAttachmentOutput, AddAttachmentOutputSchema, AddDecisionInput, AddDecisionInputSchema, AddDecisionOutput, AddDecisionOutputSchema, AddGlossaryTermInput, AddGlossaryTermInputSchema, AddGlossaryTermOutput, AddGlossaryTermOutputSchema, AddStoryLogInput, AddStoryLogInputSchema, AddStoryLogOutput, AddStoryLogOutputSchema, AddUserStoryInput, AddUserStoryInputSchema, AddUserStoryOutput, AddUserStoryOutputSchema, type AgentTaskPacket, AssignStoryToPhaseInput, AssignStoryToPhaseInputSchema, AssignStoryToPhaseOutput, AssignStoryToPhaseOutputSchema, type Attachment, CheckPlanInputSchema, CheckPlanOutput, CheckPlanOutputSchema, CreateCustomPhaseInput, CreateCustomPhaseInputSchema, CreateCustomPhaseOutput, CreateCustomPhaseOutputSchema, CreatePrdInput, CreatePrdInputSchema, CreatePrdOutput, CreatePrdOutputSchema, type CrossDependency, type CustomPhase, CustomPhaseSchema, DecideEdgeCaseInput, DecideEdgeCaseInputSchema, DecideEdgeCaseOutput, DecideEdgeCaseOutputSchema, type DecisionLogEntry, DeletePhaseInput, DeletePhaseInputSchema, DeletePrdInput, DeletePrdInputSchema, DeletePrdOutput, DeletePrdOutputSchema, DeleteUserStoryInput, DeleteUserStoryInputSchema, DeleteUserStoryOutput, DeleteUserStoryOutputSchema, type EdgeCase, ExportPrdMarkdownInput, ExportPrdMarkdownInputSchema, ExportPrdMarkdownOutput, ExportPrdMarkdownOutputSchema, GetImplementationPromptsInputSchema, GetImplementationPromptsOutput, GetImplementationPromptsOutputSchema, GetImprovementSuggestionsInputSchema, GetImprovementSuggestionsOutput, GetImprovementSuggestionsOutputSchema, GetNextStoryInputSchema, GetNextStoryOutput, GetNextStoryOutputSchema, GetPrdInput, GetPrdInputSchema, GetPrdOutput, GetPrdOutputSchema, GetProjectStatusInputSchema, GetProjectStatusOutput, GetProjectStatusOutputSchema, GetStoryInput, GetStoryInputSchema, GetStoryOutput, GetStoryOutputSchema, type GlossaryTerm, ListPrdsInputSchema, ListPrdsOutput, ListPrdsOutputSchema, ListTemplatesInputSchema, ListTemplatesOutput, ListTemplatesOutputSchema, MarkNotApplicableInput, MarkNotApplicableInputSchema, MarkNotApplicableOutput, MarkNotApplicableOutputSchema, type NotApplicableTopic, NotApplicableTopicSchema, type OpenQuestion, PhasesOutput, PhasesOutputSchema, type PlanCheckItem, type PrdDeps, PrdRevisionConflictError, PrdSection, PrdSectionValueSchemas, PrdService, PrdSummary, PrdSummarySchema, type PrdTemplate, type PrdVerificationDiagnostic, type PrdVerificationResult, RemoveAttachmentInput, RemoveAttachmentInputSchema, RemoveAttachmentOutput, RemoveAttachmentOutputSchema, ReorderPhasesInput, ReorderPhasesInputSchema, ResolveOpenQuestionInput, ResolveOpenQuestionInputSchema, ResolveOpenQuestionOutput, ResolveOpenQuestionOutputSchema, type RiskItem, StoryAttachment, StoryAttachmentSchema, type StoryComplexity, StoryComplexitySchema, type StoryLogEntry, StoryLogEntrySchema, type StoryPriority, StoryPrioritySchema, type StoryStatus, StoryStatusSchema, type StoryTraceabilityMap, type StoryVerification, StoryVerificationSchema, type StructuredPRD, type TemplateId, UpdateAttachmentInput, UpdateAttachmentInputSchema, UpdateAttachmentOutput, UpdateAttachmentOutputSchema, UpdatePhaseInput, UpdatePhaseInputSchema, UpdatePrdSectionInput, UpdatePrdSectionInputSchema, UpdatePrdSectionOutput, UpdatePrdSectionOutputSchema, UpdateStoryStatusInput, UpdateStoryStatusInputSchema, UpdateStoryStatusOutput, UpdateStoryStatusOutputSchema, UpdateUserStoryInput, UpdateUserStoryInputSchema, UpdateUserStoryOutput, UpdateUserStoryOutputSchema, type UserStory, createPrdService, normalizePrd };
|
package/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_prompts = require("./prompts-
|
|
2
|
+
const require_prompts = require("./prompts-DJQ4FQ11.js");
|
|
3
3
|
let node_path = require("node:path");
|
|
4
4
|
//#region src/edge-cases.ts
|
|
5
5
|
/**
|
|
@@ -1431,7 +1431,8 @@ var PrdService = class {
|
|
|
1431
1431
|
id: template.id,
|
|
1432
1432
|
name: template.name,
|
|
1433
1433
|
description: template.description,
|
|
1434
|
-
when_to_use: template.whenToUse
|
|
1434
|
+
when_to_use: template.whenToUse,
|
|
1435
|
+
interview_focus: template.interviewFocus
|
|
1435
1436
|
})) };
|
|
1436
1437
|
}
|
|
1437
1438
|
async checkPlan(filename) {
|
package/index.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as PrdSectionValueSchemas, A as DeleteUserStoryOutputSchema, B as GetPrdOutputSchema, C as CustomPhaseSchema, Ct as getTemplate, D as DeletePrdInputSchema, Dt as resolveAttachments, E as DeletePhaseInputSchema, Et as normalizeAttachments, F as GetImprovementSuggestionsInputSchema, G as ListPrdsInputSchema, H as GetProjectStatusOutputSchema, I as GetImprovementSuggestionsOutputSchema, J as ListTemplatesOutputSchema, K as ListPrdsOutputSchema, L as GetNextStoryInputSchema, M as ExportPrdMarkdownOutputSchema, N as GetImplementationPromptsInputSchema, O as DeletePrdOutputSchema, Ot as assertSafeFileName, P as GetImplementationPromptsOutputSchema, Q as PhasesOutputSchema, R as GetNextStoryOutputSchema, S as CreatePrdOutputSchema, St as TEMPLATE_IDS, T as DecideEdgeCaseOutputSchema, Tt as attachmentsFolder, U as GetStoryInputSchema, V as GetProjectStatusInputSchema, W as GetStoryOutputSchema, X as MarkNotApplicableOutputSchema, Y as MarkNotApplicableInputSchema, Z as NotApplicableTopicSchema, _ as CheckPlanInputSchema, _t as UpdateStoryStatusInputSchema, a as AddAttachmentInputSchema, at as ResolveOpenQuestionOutputSchema, b as CreateCustomPhaseOutputSchema, bt as UpdateUserStoryOutputSchema, c as AddDecisionOutputSchema, ct as StoryLogEntrySchema, d as AddStoryLogInputSchema, dt as StoryVerificationSchema, et as PrdSummarySchema, f as AddStoryLogOutputSchema, ft as UpdateAttachmentInputSchema, g as AssignStoryToPhaseOutputSchema, gt as UpdatePrdSectionOutputSchema, h as AssignStoryToPhaseInputSchema, ht as UpdatePrdSectionInputSchema, i as shapePrdPrompt, it as ResolveOpenQuestionInputSchema, j as ExportPrdMarkdownInputSchema, k as DeleteUserStoryInputSchema, kt as assertSafeRelativePath, l as AddGlossaryTermInputSchema, lt as StoryPrioritySchema, m as AddUserStoryOutputSchema, mt as UpdatePhaseInputSchema, n as implementStoryPrompt, nt as RemoveAttachmentOutputSchema, o as AddAttachmentOutputSchema, ot as StoryAttachmentSchema, p as AddUserStoryInputSchema, pt as UpdateAttachmentOutputSchema, q as ListTemplatesInputSchema, r as reviewStoryPrompt, rt as ReorderPhasesInputSchema, s as AddDecisionInputSchema, st as StoryComplexitySchema, t as architectPrdPrompt, tt as RemoveAttachmentInputSchema, u as AddGlossaryTermOutputSchema, ut as StoryStatusSchema, v as CheckPlanOutputSchema, vt as UpdateStoryStatusOutputSchema, w as DecideEdgeCaseInputSchema, wt as attachmentProjectPath, x as CreatePrdInputSchema, xt as PRD_TEMPLATES, y as CreateCustomPhaseInputSchema, yt as UpdateUserStoryInputSchema, z as GetPrdInputSchema } from "./prompts-
|
|
1
|
+
import { $ as PrdSectionValueSchemas, A as DeleteUserStoryOutputSchema, B as GetPrdOutputSchema, C as CustomPhaseSchema, Ct as getTemplate, D as DeletePrdInputSchema, Dt as resolveAttachments, E as DeletePhaseInputSchema, Et as normalizeAttachments, F as GetImprovementSuggestionsInputSchema, G as ListPrdsInputSchema, H as GetProjectStatusOutputSchema, I as GetImprovementSuggestionsOutputSchema, J as ListTemplatesOutputSchema, K as ListPrdsOutputSchema, L as GetNextStoryInputSchema, M as ExportPrdMarkdownOutputSchema, N as GetImplementationPromptsInputSchema, O as DeletePrdOutputSchema, Ot as assertSafeFileName, P as GetImplementationPromptsOutputSchema, Q as PhasesOutputSchema, R as GetNextStoryOutputSchema, S as CreatePrdOutputSchema, St as TEMPLATE_IDS, T as DecideEdgeCaseOutputSchema, Tt as attachmentsFolder, U as GetStoryInputSchema, V as GetProjectStatusInputSchema, W as GetStoryOutputSchema, X as MarkNotApplicableOutputSchema, Y as MarkNotApplicableInputSchema, Z as NotApplicableTopicSchema, _ as CheckPlanInputSchema, _t as UpdateStoryStatusInputSchema, a as AddAttachmentInputSchema, at as ResolveOpenQuestionOutputSchema, b as CreateCustomPhaseOutputSchema, bt as UpdateUserStoryOutputSchema, c as AddDecisionOutputSchema, ct as StoryLogEntrySchema, d as AddStoryLogInputSchema, dt as StoryVerificationSchema, et as PrdSummarySchema, f as AddStoryLogOutputSchema, ft as UpdateAttachmentInputSchema, g as AssignStoryToPhaseOutputSchema, gt as UpdatePrdSectionOutputSchema, h as AssignStoryToPhaseInputSchema, ht as UpdatePrdSectionInputSchema, i as shapePrdPrompt, it as ResolveOpenQuestionInputSchema, j as ExportPrdMarkdownInputSchema, k as DeleteUserStoryInputSchema, kt as assertSafeRelativePath, l as AddGlossaryTermInputSchema, lt as StoryPrioritySchema, m as AddUserStoryOutputSchema, mt as UpdatePhaseInputSchema, n as implementStoryPrompt, nt as RemoveAttachmentOutputSchema, o as AddAttachmentOutputSchema, ot as StoryAttachmentSchema, p as AddUserStoryInputSchema, pt as UpdateAttachmentOutputSchema, q as ListTemplatesInputSchema, r as reviewStoryPrompt, rt as ReorderPhasesInputSchema, s as AddDecisionInputSchema, st as StoryComplexitySchema, t as architectPrdPrompt, tt as RemoveAttachmentInputSchema, u as AddGlossaryTermOutputSchema, ut as StoryStatusSchema, v as CheckPlanOutputSchema, vt as UpdateStoryStatusOutputSchema, w as DecideEdgeCaseInputSchema, wt as attachmentProjectPath, x as CreatePrdInputSchema, xt as PRD_TEMPLATES, y as CreateCustomPhaseInputSchema, yt as UpdateUserStoryInputSchema, z as GetPrdInputSchema } from "./prompts-B0VejF7q.mjs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
//#region src/edge-cases.ts
|
|
4
4
|
/**
|
|
@@ -1430,7 +1430,8 @@ var PrdService = class {
|
|
|
1430
1430
|
id: template.id,
|
|
1431
1431
|
name: template.name,
|
|
1432
1432
|
description: template.description,
|
|
1433
|
-
when_to_use: template.whenToUse
|
|
1433
|
+
when_to_use: template.whenToUse,
|
|
1434
|
+
interview_focus: template.interviewFocus
|
|
1434
1435
|
})) };
|
|
1435
1436
|
}
|
|
1436
1437
|
async checkPlan(filename) {
|
package/mcp.d.ts
CHANGED
package/mcp.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_prompts = require("./prompts-
|
|
2
|
+
const require_prompts = require("./prompts-DJQ4FQ11.js");
|
|
3
3
|
let zod_v3 = require("zod/v3");
|
|
4
4
|
//#region src/mcp/tool-response.ts
|
|
5
5
|
/**
|
|
@@ -122,7 +122,7 @@ function registerPRDTools(server, service) {
|
|
|
122
122
|
});
|
|
123
123
|
server.registerTool("add_user_story", {
|
|
124
124
|
title: "Add a user story",
|
|
125
|
-
description: "Append a user story with acceptance criteria to a PRD.",
|
|
125
|
+
description: "Append a user story with acceptance criteria to a PRD. A story is one commit-sized change: one behaviour a test can check (not a single button, field or migration), leaving the build passing.",
|
|
126
126
|
inputSchema: require_prompts.AddUserStoryInputSchema,
|
|
127
127
|
outputSchema: require_prompts.AddUserStoryOutputSchema,
|
|
128
128
|
annotations: MUTATING_TOOL
|
|
@@ -487,15 +487,14 @@ function registerPRDTools(server, service) {
|
|
|
487
487
|
title: "Shape a PRD",
|
|
488
488
|
description: "Interview the user round by round until the plan is clear, writing each decision into the PRD as it is made, then slice the work into stories and phases.",
|
|
489
489
|
argsSchema: {
|
|
490
|
-
|
|
491
|
-
filename: zod_v3.z.string().optional().describe("Existing PRD to keep shaping, inside .prds")
|
|
492
|
-
template: zod_v3.z.enum(require_prompts.TEMPLATE_IDS).optional().describe("Kind of work, see list_templates")
|
|
490
|
+
overview: zod_v3.z.string().optional().describe("What you want to build, in your own words: what it is, who it is for and what it should do"),
|
|
491
|
+
filename: zod_v3.z.string().optional().describe("Existing PRD to keep shaping, inside .prds")
|
|
493
492
|
}
|
|
494
|
-
}, ({
|
|
493
|
+
}, ({ overview, filename }) => ({ messages: [{
|
|
495
494
|
role: "user",
|
|
496
495
|
content: {
|
|
497
496
|
type: "text",
|
|
498
|
-
text: require_prompts.shapePrdPrompt(
|
|
497
|
+
text: require_prompts.shapePrdPrompt(overview, filename)
|
|
499
498
|
}
|
|
500
499
|
}] }));
|
|
501
500
|
server.registerPrompt("architect_prd", {
|
package/mcp.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { A as DeleteUserStoryOutputSchema, B as GetPrdOutputSchema, D as DeletePrdInputSchema, E as DeletePhaseInputSchema, F as GetImprovementSuggestionsInputSchema, G as ListPrdsInputSchema, H as GetProjectStatusOutputSchema, I as GetImprovementSuggestionsOutputSchema, J as ListTemplatesOutputSchema, K as ListPrdsOutputSchema, L as GetNextStoryInputSchema, M as ExportPrdMarkdownOutputSchema, N as GetImplementationPromptsInputSchema, O as DeletePrdOutputSchema, P as GetImplementationPromptsOutputSchema, Q as PhasesOutputSchema, R as GetNextStoryOutputSchema, S as CreatePrdOutputSchema,
|
|
1
|
+
import { A as DeleteUserStoryOutputSchema, B as GetPrdOutputSchema, D as DeletePrdInputSchema, E as DeletePhaseInputSchema, F as GetImprovementSuggestionsInputSchema, G as ListPrdsInputSchema, H as GetProjectStatusOutputSchema, I as GetImprovementSuggestionsOutputSchema, J as ListTemplatesOutputSchema, K as ListPrdsOutputSchema, L as GetNextStoryInputSchema, M as ExportPrdMarkdownOutputSchema, N as GetImplementationPromptsInputSchema, O as DeletePrdOutputSchema, P as GetImplementationPromptsOutputSchema, Q as PhasesOutputSchema, R as GetNextStoryOutputSchema, S as CreatePrdOutputSchema, T as DecideEdgeCaseOutputSchema, U as GetStoryInputSchema, V as GetProjectStatusInputSchema, W as GetStoryOutputSchema, X as MarkNotApplicableOutputSchema, Y as MarkNotApplicableInputSchema, _ as CheckPlanInputSchema, _t as UpdateStoryStatusInputSchema, a as AddAttachmentInputSchema, at as ResolveOpenQuestionOutputSchema, b as CreateCustomPhaseOutputSchema, bt as UpdateUserStoryOutputSchema, c as AddDecisionOutputSchema, d as AddStoryLogInputSchema, f as AddStoryLogOutputSchema, ft as UpdateAttachmentInputSchema, g as AssignStoryToPhaseOutputSchema, gt as UpdatePrdSectionOutputSchema, h as AssignStoryToPhaseInputSchema, ht as UpdatePrdSectionInputSchema, i as shapePrdPrompt, it as ResolveOpenQuestionInputSchema, j as ExportPrdMarkdownInputSchema, k as DeleteUserStoryInputSchema, l as AddGlossaryTermInputSchema, m as AddUserStoryOutputSchema, mt as UpdatePhaseInputSchema, n as implementStoryPrompt, nt as RemoveAttachmentOutputSchema, o as AddAttachmentOutputSchema, p as AddUserStoryInputSchema, pt as UpdateAttachmentOutputSchema, q as ListTemplatesInputSchema, r as reviewStoryPrompt, rt as ReorderPhasesInputSchema, s as AddDecisionInputSchema, t as architectPrdPrompt, tt as RemoveAttachmentInputSchema, u as AddGlossaryTermOutputSchema, v as CheckPlanOutputSchema, vt as UpdateStoryStatusOutputSchema, w as DecideEdgeCaseInputSchema, x as CreatePrdInputSchema, y as CreateCustomPhaseInputSchema, yt as UpdateUserStoryInputSchema, z as GetPrdInputSchema } from "./prompts-B0VejF7q.mjs";
|
|
2
2
|
import { z } from "zod/v3";
|
|
3
3
|
//#region src/mcp/tool-response.ts
|
|
4
4
|
/**
|
|
@@ -121,7 +121,7 @@ function registerPRDTools(server, service) {
|
|
|
121
121
|
});
|
|
122
122
|
server.registerTool("add_user_story", {
|
|
123
123
|
title: "Add a user story",
|
|
124
|
-
description: "Append a user story with acceptance criteria to a PRD.",
|
|
124
|
+
description: "Append a user story with acceptance criteria to a PRD. A story is one commit-sized change: one behaviour a test can check (not a single button, field or migration), leaving the build passing.",
|
|
125
125
|
inputSchema: AddUserStoryInputSchema,
|
|
126
126
|
outputSchema: AddUserStoryOutputSchema,
|
|
127
127
|
annotations: MUTATING_TOOL
|
|
@@ -486,15 +486,14 @@ function registerPRDTools(server, service) {
|
|
|
486
486
|
title: "Shape a PRD",
|
|
487
487
|
description: "Interview the user round by round until the plan is clear, writing each decision into the PRD as it is made, then slice the work into stories and phases.",
|
|
488
488
|
argsSchema: {
|
|
489
|
-
|
|
490
|
-
filename: z.string().optional().describe("Existing PRD to keep shaping, inside .prds")
|
|
491
|
-
template: z.enum(TEMPLATE_IDS).optional().describe("Kind of work, see list_templates")
|
|
489
|
+
overview: z.string().optional().describe("What you want to build, in your own words: what it is, who it is for and what it should do"),
|
|
490
|
+
filename: z.string().optional().describe("Existing PRD to keep shaping, inside .prds")
|
|
492
491
|
}
|
|
493
|
-
}, ({
|
|
492
|
+
}, ({ overview, filename }) => ({ messages: [{
|
|
494
493
|
role: "user",
|
|
495
494
|
content: {
|
|
496
495
|
type: "text",
|
|
497
|
-
text: shapePrdPrompt(
|
|
496
|
+
text: shapePrdPrompt(overview, filename)
|
|
498
497
|
}
|
|
499
498
|
}] }));
|
|
500
499
|
server.registerPrompt("architect_prd", {
|
package/node.d.ts
CHANGED
package/package.json
CHANGED
|
@@ -2138,16 +2138,19 @@ declare const ListTemplatesOutputSchema: z.ZodObject<{
|
|
|
2138
2138
|
name: z.ZodString;
|
|
2139
2139
|
description: z.ZodString;
|
|
2140
2140
|
when_to_use: z.ZodString;
|
|
2141
|
+
interview_focus: z.ZodArray<z.ZodString, "many">;
|
|
2141
2142
|
}, "strip", z.ZodTypeAny, {
|
|
2142
2143
|
name: string;
|
|
2143
2144
|
description: string;
|
|
2144
2145
|
id: string;
|
|
2145
2146
|
when_to_use: string;
|
|
2147
|
+
interview_focus: string[];
|
|
2146
2148
|
}, {
|
|
2147
2149
|
name: string;
|
|
2148
2150
|
description: string;
|
|
2149
2151
|
id: string;
|
|
2150
2152
|
when_to_use: string;
|
|
2153
|
+
interview_focus: string[];
|
|
2151
2154
|
}>, "many">;
|
|
2152
2155
|
}, "strip", z.ZodTypeAny, {
|
|
2153
2156
|
templates: {
|
|
@@ -2155,6 +2158,7 @@ declare const ListTemplatesOutputSchema: z.ZodObject<{
|
|
|
2155
2158
|
description: string;
|
|
2156
2159
|
id: string;
|
|
2157
2160
|
when_to_use: string;
|
|
2161
|
+
interview_focus: string[];
|
|
2158
2162
|
}[];
|
|
2159
2163
|
}, {
|
|
2160
2164
|
templates: {
|
|
@@ -2162,6 +2166,7 @@ declare const ListTemplatesOutputSchema: z.ZodObject<{
|
|
|
2162
2166
|
description: string;
|
|
2163
2167
|
id: string;
|
|
2164
2168
|
when_to_use: string;
|
|
2169
|
+
interview_focus: string[];
|
|
2165
2170
|
}[];
|
|
2166
2171
|
}>;
|
|
2167
2172
|
type ListTemplatesOutput = z.infer<typeof ListTemplatesOutputSchema>;
|
|
@@ -767,7 +767,8 @@ const ListTemplatesOutputSchema = z.object({ templates: z.array(z.object({
|
|
|
767
767
|
id: z.string(),
|
|
768
768
|
name: z.string(),
|
|
769
769
|
description: z.string(),
|
|
770
|
-
when_to_use: z.string()
|
|
770
|
+
when_to_use: z.string(),
|
|
771
|
+
interview_focus: z.array(z.string())
|
|
771
772
|
})) });
|
|
772
773
|
//#endregion
|
|
773
774
|
//#region src/prompts.ts
|
|
@@ -775,10 +776,9 @@ const ListTemplatesOutputSchema = z.object({ templates: z.array(z.object({
|
|
|
775
776
|
* The instructions behind the MCP prompts, exported so other tools (e.g. a
|
|
776
777
|
* UI that shows what to ask the agent) give exactly the same text.
|
|
777
778
|
*/
|
|
778
|
-
function shapePrdPrompt(
|
|
779
|
-
const template = templateId ? getTemplate(templateId) : null;
|
|
779
|
+
function shapePrdPrompt(overview, filename) {
|
|
780
780
|
return [
|
|
781
|
-
`We are shaping a product requirements document before any code is written. ${filename ? `Keep shaping the PRD "${filename}". Read it with get_prd first and continue from its open questions.` :
|
|
781
|
+
`We are shaping a product requirements document before any code is written. ${filename ? `Keep shaping the PRD "${filename}". Read it with get_prd first and continue from its open questions.` : overview ? `What the user wants to build:\n\n${overview}\n\nTreat this as the starting point: do not ask again what it already answers.` : "Start by asking the user to describe what they want to build, in their own words: what it is, who it is for and what it should do."}`,
|
|
782
782
|
"",
|
|
783
783
|
"How to run the interview:",
|
|
784
784
|
"- Think of the plan as a tree of decisions. In each round, ask only the questions that can be answered now, i.e. whose prerequisites are already decided. Number them.",
|
|
@@ -789,7 +789,7 @@ function shapePrdPrompt(idea, filename, templateId) {
|
|
|
789
789
|
"- After each round, record what was decided before asking the next round.",
|
|
790
790
|
"- Stop when no undecided questions remain, and confirm with the user before slicing the work.",
|
|
791
791
|
"",
|
|
792
|
-
template
|
|
792
|
+
"Pick the template yourself instead of asking the user: call list_templates, choose the one whose when_to_use fits what they described, pass it to create_prd and cover its interview_focus questions in the rounds. If none fits, create the PRD without one.",
|
|
793
793
|
"",
|
|
794
794
|
"Order of the rounds, broad to detailed:",
|
|
795
795
|
"1. What we are building and for whom (create_prd once this is clear, if there is no PRD yet).",
|
|
@@ -806,7 +806,9 @@ function shapePrdPrompt(idea, filename, templateId) {
|
|
|
806
806
|
"12. If a part genuinely does not apply (no outside services; no rollout plan for an internal tool), mark it with mark_not_applicable and a reason instead of leaving it empty. Never mark security or edge cases as not applicable for a feature that takes input from people or stores their data.",
|
|
807
807
|
"",
|
|
808
808
|
"Then slice the work:",
|
|
809
|
-
"- Each story is
|
|
809
|
+
"- Each story is one commit: a small, self-contained change that leaves the build passing and is tested, and that a reviewer can read in a few minutes. Aim for one behaviour per story, usually a handful of files and one or two test seams. A story does not have to be something a person can try on its own; the phase is.",
|
|
810
|
+
"- Size stories small. Split one that has more than three or four acceptance criteria, covers several screens, endpoints or roles, or needs \"and\" in its title. More small stories are better than a few broad ones. Still slice vertically where you can (one field end to end, not every field in one layer), and put refactoring needed by later stories in its own earlier story.",
|
|
811
|
+
"- But not smaller than one behaviour. A story must change what the system does in a way a test can check through a seam: \"a member can archive a project and it disappears from the list\", not \"add an archive button\". A button, field, route, migration or config change on its own is a task, not a story: fold it into the story whose behaviour needs it. Merge stories whose acceptance criteria only describe what is on the screen, or that cannot be tested without the next story.",
|
|
810
812
|
"- Create the phases first (create_custom_phase), in the order they should be built. Each phase should end with something a person can try (a page in the app, an API call, a command); say what in its description.",
|
|
811
813
|
"- Add each story with add_user_story in one call: testSeams (the public entry points the tests will exercise), dependencies (stories that must be completed first) and phaseId. Add designNotes when the story has a screen or states the PRD design guidance does not settle, and securityNotes for each way this story in particular could be abused (whose ids it accepts, what input it trusts, what it costs to repeat) with the defence. Do not repeat the PRD-wide guidance or considerations there.",
|
|
812
814
|
"- When the user shares mockups, screenshots or reference docs, save each file in the PRD folder (.prds/<prd file name without .json>/) and record it with add_attachment, linking the stories that use it. Record links to outside docs with a url instead.",
|
|
@@ -767,7 +767,8 @@ const ListTemplatesOutputSchema = zod_v3.z.object({ templates: zod_v3.z.array(zo
|
|
|
767
767
|
id: zod_v3.z.string(),
|
|
768
768
|
name: zod_v3.z.string(),
|
|
769
769
|
description: zod_v3.z.string(),
|
|
770
|
-
when_to_use: zod_v3.z.string()
|
|
770
|
+
when_to_use: zod_v3.z.string(),
|
|
771
|
+
interview_focus: zod_v3.z.array(zod_v3.z.string())
|
|
771
772
|
})) });
|
|
772
773
|
//#endregion
|
|
773
774
|
//#region src/prompts.ts
|
|
@@ -775,10 +776,9 @@ const ListTemplatesOutputSchema = zod_v3.z.object({ templates: zod_v3.z.array(zo
|
|
|
775
776
|
* The instructions behind the MCP prompts, exported so other tools (e.g. a
|
|
776
777
|
* UI that shows what to ask the agent) give exactly the same text.
|
|
777
778
|
*/
|
|
778
|
-
function shapePrdPrompt(
|
|
779
|
-
const template = templateId ? getTemplate(templateId) : null;
|
|
779
|
+
function shapePrdPrompt(overview, filename) {
|
|
780
780
|
return [
|
|
781
|
-
`We are shaping a product requirements document before any code is written. ${filename ? `Keep shaping the PRD "${filename}". Read it with get_prd first and continue from its open questions.` :
|
|
781
|
+
`We are shaping a product requirements document before any code is written. ${filename ? `Keep shaping the PRD "${filename}". Read it with get_prd first and continue from its open questions.` : overview ? `What the user wants to build:\n\n${overview}\n\nTreat this as the starting point: do not ask again what it already answers.` : "Start by asking the user to describe what they want to build, in their own words: what it is, who it is for and what it should do."}`,
|
|
782
782
|
"",
|
|
783
783
|
"How to run the interview:",
|
|
784
784
|
"- Think of the plan as a tree of decisions. In each round, ask only the questions that can be answered now, i.e. whose prerequisites are already decided. Number them.",
|
|
@@ -789,7 +789,7 @@ function shapePrdPrompt(idea, filename, templateId) {
|
|
|
789
789
|
"- After each round, record what was decided before asking the next round.",
|
|
790
790
|
"- Stop when no undecided questions remain, and confirm with the user before slicing the work.",
|
|
791
791
|
"",
|
|
792
|
-
template
|
|
792
|
+
"Pick the template yourself instead of asking the user: call list_templates, choose the one whose when_to_use fits what they described, pass it to create_prd and cover its interview_focus questions in the rounds. If none fits, create the PRD without one.",
|
|
793
793
|
"",
|
|
794
794
|
"Order of the rounds, broad to detailed:",
|
|
795
795
|
"1. What we are building and for whom (create_prd once this is clear, if there is no PRD yet).",
|
|
@@ -806,7 +806,9 @@ function shapePrdPrompt(idea, filename, templateId) {
|
|
|
806
806
|
"12. If a part genuinely does not apply (no outside services; no rollout plan for an internal tool), mark it with mark_not_applicable and a reason instead of leaving it empty. Never mark security or edge cases as not applicable for a feature that takes input from people or stores their data.",
|
|
807
807
|
"",
|
|
808
808
|
"Then slice the work:",
|
|
809
|
-
"- Each story is
|
|
809
|
+
"- Each story is one commit: a small, self-contained change that leaves the build passing and is tested, and that a reviewer can read in a few minutes. Aim for one behaviour per story, usually a handful of files and one or two test seams. A story does not have to be something a person can try on its own; the phase is.",
|
|
810
|
+
"- Size stories small. Split one that has more than three or four acceptance criteria, covers several screens, endpoints or roles, or needs \"and\" in its title. More small stories are better than a few broad ones. Still slice vertically where you can (one field end to end, not every field in one layer), and put refactoring needed by later stories in its own earlier story.",
|
|
811
|
+
"- But not smaller than one behaviour. A story must change what the system does in a way a test can check through a seam: \"a member can archive a project and it disappears from the list\", not \"add an archive button\". A button, field, route, migration or config change on its own is a task, not a story: fold it into the story whose behaviour needs it. Merge stories whose acceptance criteria only describe what is on the screen, or that cannot be tested without the next story.",
|
|
810
812
|
"- Create the phases first (create_custom_phase), in the order they should be built. Each phase should end with something a person can try (a page in the app, an API call, a command); say what in its description.",
|
|
811
813
|
"- Add each story with add_user_story in one call: testSeams (the public entry points the tests will exercise), dependencies (stories that must be completed first) and phaseId. Add designNotes when the story has a screen or states the PRD design guidance does not settle, and securityNotes for each way this story in particular could be abused (whose ids it accepts, what input it trusts, what it costs to repeat) with the defence. Do not repeat the PRD-wide guidance or considerations there.",
|
|
812
814
|
"- When the user shares mockups, screenshots or reference docs, save each file in the PRD folder (.prds/<prd file name without .json>/) and record it with add_attachment, linking the stories that use it. Record links to outside docs with a url instead.",
|