ryanlewis

Creating a PRD with AI Assistance: A Case Study

How we used AI to streamline Product Requirements Document creation for an MCP server proof of concept

Introduction

We all know that Product Requirements Documents (PRDs) are essential for any software project - they define expectations, technical specs, and success criteria. But let's be honest: creating comprehensive PRDs can be pretty time-consuming, especially when you're trying to make sure you haven't missed any technical details or edge cases.

This blog post walks through our real-world experience creating a PRD for an MCP (Model Context Protocol) dice roll server - a proof-of-concept project we needed to validate our organisation's adoption of MCP technology. What made this interesting was how we used AI assistance to speed up the whole process while keeping the quality high.

ryanlewis

const points = {
    'immortal': 7,
    'diamond': 6,
    'platinum': 5,
    'gold': 4,
    'silver': 3,
    'bronze': 2,
    'iron': 1,
};

ryanlewis

-- Redis script to implement a leaky bucket
-- see https://medium.com/callr-techblog/rate-limiting-for-distributed-systems-with-redis-and-lua-eeea745cb260
-- (c) Florent CHAUVEAU <[email protected]>

local ts  = tonumber(ARGV[1])
local cps = tonumber(ARGV[2])
local key = KEYS[1]

-- remove tokens < min (older than now() -1s)
local min = ts -1

ryanlewis

kubectl get rs,secrets -o json --namespace old | jq '.items[].metadata.namespace = "new"' | kubectl create-f  -

ryanlewis

public class ContourFormRefreshPayload
{
    public Guid Id { get; set; }
}

public class ContourFormCacheRefresher : JsonCacheRefresherBase<ContourFormCacheRefresher>
{
    public static string Id = "AA2970FD-8785-42C2-A289-A7A6614CAE45";
    protected override ContourFormCacheRefresher Instance => this;
    public override Guid UniqueIdentifier => new Guid(Id);

ryanlewis

using System.Web.UI;
using Examine;
using Examine.LuceneEngine;
using Examine.LuceneEngine.Providers;
using Umbraco.Core;
using Umbraco.Web;

namespace AMAZINGWEBSITE.Web.Core.ApplicationEventHandlers
{
    public class ConfigureLuceneIndexing : IApplicationEventHandler

ryanlewis

using System;
using System.Linq;
using System.Text.RegularExpressions;
using System.Web;

namespace MyUmbracoSite.Core.Extensions
{
    public static class StringExtensions
    {
        // http://bendetat.com/the-greatest-string-formatwith-implementation-in-the-world.html

ryanlewis

Windows Registry Editor Version 5.00

; This will make it appear when you right click ON a folder
; The "Icon" line can be removed if you don't want the icon to appear

[HKEY_CLASSES_ROOT\Directory\shell\sublime]
@="Open Folder as &Sublime Project"
"Icon"="\"C:\\Program Files\\Sublime Text 3\\sublime_text.exe\",0"

[HKEY_CLASSES_ROOT\Directory\shell\sublime\command]

ryanlewis

@inherits UmbracoTemplatePage
@{
    var parent = Model.Content.Parent;
    while (true)
    {
        if (parent.TemplateId > 0 && parent.TemplateId != Model.Content.TemplateId) 
        {
            break;
        }
        parent = parent.Parent;

ryanlewis

<Project>
  <Target Name="BeforeBuild">
    <Exec WorkingDirectory="..\.." Command="powershell.exe .\grunt-build.ps1 -target $(Configuration)" />
    <ItemGroup>
      <Content Include="css\**\*.css" />
      <Content Include="js\**\*.js" />
      <Content Include="js\**\*.js.map" />
      <Content Include="fonts\**\*.*" />
      <Content Include="img\**\*.png" />
      <Content Include="img\**\*.gif" />