<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/guides/how-to/scenarios/agency-client-demo/">
  <id>https://docs.spec-kitty.ai/guides/how-to/scenarios/agency-client-demo/</id>
  <title>Agency Client Transparency Workflow</title>
  <updated>2026-08-10T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/guides/how-to/scenarios/agency-client-demo/"/>
  <summary>Give agency clients read-only visibility into Spec Kitty mission progress through status reports without exposing any source code.</summary>
  <content type="html">&lt;span id=&quot;agency-client-transparency-workflow&quot;&gt;&lt;/span&gt;
&lt;p&gt;Use Spec Kitty’s lane-based status output to provide development visibility to clients without exposing code.&lt;/p&gt;
&lt;h2 id=&quot;setup&quot;&gt;Setup&lt;/h2&gt;
&lt;h3 id=&quot;1-share-status-with-the-client&quot;&gt;1. Share Status with the Client&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Human-readable lane board for the Mission&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tasks&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;status&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Machine-readable snapshot to paste into a report or shared doc&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tasks&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;status&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--json&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;status-report.json&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;The bundled local web dashboard has been removed. A read-only Mission Status Read API (&lt;a href=&quot;https://github.com/spec-kitty/spec-kitty/issues/5528&quot;&gt;#5528&lt;/a&gt;) is planned as the contract for a replacement UI, which will live in its own repository. Until then, share status output and spec artifacts directly.&lt;/p&gt;
&lt;h3 id=&quot;2-what-client-sees&quot;&gt;2. What Client Sees&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Lane board&lt;/strong&gt; - Tasks grouped by lane&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Mission summary&lt;/strong&gt; - Titles and progress&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Artifact links&lt;/strong&gt; - Access to spec.md (requirements) and plan.md (architecture)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Agent assignments&lt;/strong&gt; - Which developer/AI is working on what&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No code&lt;/strong&gt; - Only specifications and task status, not implementation&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;client-meeting-patterns&quot;&gt;Client Meeting Patterns&lt;/h2&gt;
&lt;h3 id=&quot;sprint-planning-meeting&quot;&gt;Sprint Planning Meeting&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Before Meeting:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.specify&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Build a customer dashboard showing:&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;- Recent order history&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;- Account settings management&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;- Support ticket submission&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;- Real-time order tracking&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;During Meeting:&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Share screen&lt;/strong&gt; showing &lt;code dir=&quot;auto&quot;&gt;kitty-specs/002-customer-dashboard/spec.md&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Walk through&lt;/strong&gt; user stories and acceptance criteria&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Client feedback&lt;/strong&gt; → Update spec.md live&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Confirm scope&lt;/strong&gt; → Resolve open questions directly in &lt;code dir=&quot;auto&quot;&gt;spec.md&lt;/code&gt; before planning&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Show status&lt;/strong&gt; → Client sees the new Mission appear in &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;After Meeting:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Client receives the next status report&lt;/li&gt;
&lt;li&gt;Sees tasks appear in “planned” lane as you run &lt;code dir=&quot;auto&quot;&gt;/spec-kitty.tasks&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;daily-standup-async-via-status-reports&quot;&gt;Daily Standup (Async via Status Reports)&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Client reviews the daily status report:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Morning:&lt;/strong&gt; Sees tasks moved to “doing” lane&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Afternoon:&lt;/strong&gt; Watches progress (tasks moving to “review”)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No email needed:&lt;/strong&gt; Visual progress replaces status update requests&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;PM responsibilities:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Update spec.md if requirements change&lt;/li&gt;
&lt;li&gt;Add notes to work package files explaining blockers&lt;/li&gt;
&lt;li&gt;Move stuck tasks back to “planned” with client-friendly notes&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;weekly-review-meeting&quot;&gt;Weekly Review Meeting&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Agenda:&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Review status&lt;/strong&gt; for completed work (done lane)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Demo features&lt;/strong&gt; from completed work packages&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Show velocity&lt;/strong&gt; - “We completed 8 work packages this week”&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Review upcoming&lt;/strong&gt; - Show “planned” lane for next week&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Export evidence&lt;/strong&gt; - Share spec.md and status reports&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;trust-building-workflow&quot;&gt;Trust-Building Workflow&lt;/h2&gt;
&lt;h3 id=&quot;problem-how-do-i-know-youre-making-progress&quot;&gt;Problem: “How do I know you’re making progress?”&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Traditional agency:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Weekly status emails&lt;/li&gt;
&lt;li&gt;Client calls asking “are you done yet?”&lt;/li&gt;
&lt;li&gt;Screenshots of code (client can’t understand)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;With Spec Kitty status reports:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Client sees task movement&lt;/li&gt;
&lt;li&gt;Activity logs prove work is happening&lt;/li&gt;
&lt;li&gt;Spec artifacts explain what’s being built&lt;/li&gt;
&lt;li&gt;No need to ask for updates&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;example-timeline&quot;&gt;Example Timeline&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Monday 9 AM:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.specify&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Create admin panel for content moderation...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Client sees: Mission “003-admin-panel” appears in the status report&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Monday 11 AM:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.plan&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Use Next.js, PostgreSQL, AWS S3...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Client sees: plan.md artifact link appears&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Monday 2 PM:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.tasks&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Client sees: 6 work packages appear in “planned” lane&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Tuesday-Thursday:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.implement (repeated)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Client sees: Tasks moving planned → doing → review → done&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Friday:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;text&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.accept&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;/spec-kitty.merge --push&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Client sees: Feature marked complete, demo scheduled&lt;/p&gt;
&lt;h2 id=&quot;client-communication&quot;&gt;Client Communication&lt;/h2&gt;
&lt;h3 id=&quot;explaining-the-status-report&quot;&gt;Explaining the Status Report&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;To Client:&lt;/strong&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“We use Spec Kitty to give you regular visibility. Here’s what you’re seeing:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Blue (Planned):&lt;/strong&gt; Work we’ll do next&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Yellow (Doing):&lt;/strong&gt; What we’re actively building&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Orange (Review):&lt;/strong&gt; What’s done, pending our internal QA&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Green (Done):&lt;/strong&gt; Completed and merged&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Each task has a work package file you can read - it explains what we’re building in plain English. You’ll never see code unless you want to.”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id=&quot;setting-expectations&quot;&gt;Setting Expectations&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;What clients love:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;“I can check progress anytime without bothering you”&lt;/li&gt;
&lt;li&gt;“I finally understand what you’re building”&lt;/li&gt;
&lt;li&gt;“The transparency builds trust”&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;What to clarify:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Tasks in “doing” might sit there a while (complex work)&lt;/li&gt;
&lt;li&gt;“Review” means internal QA, not client approval (unless you want that)&lt;/li&gt;
&lt;li&gt;Status changes as work happens, which is often in bursts&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;advanced-client-collaboration&quot;&gt;Advanced: Client Collaboration&lt;/h2&gt;
&lt;h3 id=&quot;allow-client-to-review-work&quot;&gt;Allow Client to Review Work&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Workflow:&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Client gets GitHub access to spec files only (not code)&lt;/li&gt;
&lt;li&gt;Client reviews work packages in &lt;code dir=&quot;auto&quot;&gt;tasks/for_review/&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Client adds comments to work package markdown files&lt;/li&gt;
&lt;li&gt;PM moves tasks back to “planned” or forward to “done” based on feedback&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Script:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# PM shows client the work package file&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;cat&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;kitty-specs/003-admin-panel/tasks/for_review/WP01-user-list.md&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Client adds feedback (via GitHub UI or shared doc)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# PM moves based on feedback&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;agent&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;action&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;implement&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;WP01&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;metrics-to-share&quot;&gt;Metrics to Share&lt;/h2&gt;
&lt;p&gt;Export these for client reports:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# 1. Mission state and WP lanes (machine-readable)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;spec-kitty&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;orchestrator-api&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;mission-state&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;--mission&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;&amp;#x3C;slug&gt;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# 2. Tasks completed this week&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;grep&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;lane=done&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;kitty-specs/&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;/tasks/done/&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;.md&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;|&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;wc&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-l&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# 3. Velocity trend&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Count work packages completed per week from activity logs&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;client-success-stories&quot;&gt;Client Success Stories&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;“Before Spec Kitty:”&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Client called daily asking for updates&lt;/li&gt;
&lt;li&gt;Developer spent 2 hours/week writing status emails&lt;/li&gt;
&lt;li&gt;Client surprised by deliverables not matching expectations&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;“After Spec Kitty:”&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Client reads status reports independently&lt;/li&gt;
&lt;li&gt;Zero status update requests&lt;/li&gt;
&lt;li&gt;Spec.md alignment prevents scope surprises&lt;/li&gt;
&lt;li&gt;Client references status reports in their own meetings&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;tips-for-agencies&quot;&gt;Tips for Agencies&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Status automation&lt;/strong&gt; - Post daily &lt;code dir=&quot;auto&quot;&gt;spec-kitty agent tasks status&lt;/code&gt; output to Slack/email&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Spec.md templates&lt;/strong&gt; - Standardize how you write specifications&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Charter per client&lt;/strong&gt; - Different quality standards for different clients&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Status reports as sales tool&lt;/strong&gt; - Show prospects how projects are tracked&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;common-questions&quot;&gt;Common Questions&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Q: Can clients break anything through a status report?&lt;/strong&gt;
A: No, status output is read-only. They see status, can’t change it.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q: What if client wants to hide certain features?&lt;/strong&gt;
A: Use separate projects for client-visible vs internal work.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q: Can multiple clients share a status report?&lt;/strong&gt;
A: Not recommended - use separate project instances per client.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Q: How do we bill based on tracked activity?&lt;/strong&gt;
A: Activity logs show timestamps - export for time tracking integration.&lt;/p&gt;</content>
</entry>
