<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Cairn blog</title>
    <link>https://cairnfed.ai/blog</link>
    <description>How-to guides from the Cairn team: setting up a company profile that scores well, finding and qualifying SAM.gov and Grants.gov opportunities, working the capture pipeline, and writing a proposal with the AI.</description>
    <language>en-us</language>
    <lastBuildDate>Mon, 14 Sep 2026 12:00:00 GMT</lastBuildDate>
    <atom:link href="https://cairnfed.ai/blog/feed.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>The proposal writer, part 2: compliance, reviews, and the package</title>
      <link>https://cairnfed.ai/blog/proposal-writer-part-2-review-and-submission</link>
      <guid isPermaLink="true">https://cairnfed.ai/blog/proposal-writer-part-2-review-and-submission</guid>
      <pubDate>Mon, 14 Sep 2026 12:00:00 GMT</pubDate>
      <category>Proposals</category>
      <category>Compliance</category>
      <category>Grants.gov</category>
      <category>Submission</category>
      <description>The back half of a proposal in Cairn: the compliance matrix, color-team and AI reviews, the readiness checklist, and filing with Grants.gov.</description>
      <content:encoded><![CDATA[<p><a href="/blog/proposal-writer-part-1-sources-shred-drafts">Part one</a> ended with a drafted document and a compliance matrix behind it. This post is about the part of proposal work that loses bids when it&#39;s skipped: proving you answered every requirement, getting real reviewers to read it, and making sure the package that goes out the door is complete. Cairn is opinionated here. The submission package will not let you approve it while a blocking check is open, and we think that&#39;s the most useful single feature in the workspace.</p>
<p>Everything below lives in the rail&#39;s <strong>Workspace</strong> group.</p>
<h2 id="work-the-compliance-matrix">Work the compliance matrix</h2>
<p>The shred turned every requirement it found in the solicitation into a row. Open <strong>Compliance matrix</strong> from the rail and each row has a status you can set to <strong>Open</strong>, <strong>Addressed</strong>, or <strong>N/A</strong>, plus an <strong>Addressed by section</strong> picker mapping it to the section that answers it. The rail shows a running count and a mini-bar, so you can see coverage without opening the drawer.</p>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/compliance-matrix.png" alt="The Compliance matrix drawer: a coverage line reading 0 percent addressed, 42 requirements, and a row per requirement with a status select reading Open, the requirement text with its section reference, and an Addressed by section select" width="780" height="900" loading="lazy" decoding="async" /><figcaption>Every requirement the shred found, waiting to be mapped.</figcaption></figure>
<p>Two ways to close a row. Write the answer yourself in the mapped section, then mark the row Addressed. Or click the AI button on the row, which drafts the mapped section to address that requirement; the same thing is available from inside the section editor as <strong>Address requirement…</strong>, which rewrites a highlighted selection to answer a specific row. Either way, the matrix stays fully editable, and it ships in the export as a compliance checklist so an evaluator can trace every requirement to a page.</p>
<p>Our advice: work the matrix before the review rounds, not after. Reviewers should be reading a proposal that&#39;s already compliant, so their attention goes to persuasion.</p>
<h2 id="review-rounds-and-color-teams">Review rounds and color teams</h2>
<p>Color teams are the traditional proposal review sequence, and Cairn uses the standard names: <strong>Blue</strong> for strategy and win themes, <strong>Pink</strong> for the first full draft, <strong>Red</strong> for compliance and competitiveness, <strong>Gold</strong> for the final executive review, <strong>Green</strong> for pricing and cost, and <strong>White</strong> for lessons learned.</p>
<p>Open <strong>Review rounds</strong>, pick a color team, give the round a due date, and click <strong>Add round</strong>. A round moves through <strong>Planned</strong>, <strong>In progress</strong>, and <strong>Complete</strong>. Reviewers work in the section editor&#39;s <strong>Review</strong> mode: highlight a span of text and pin a comment to it. Each comment belongs to the active round and carries a severity: <strong>Must</strong> (blocking), <strong>Should</strong>, or <strong>Consider</strong>. Comments can be resolved as they&#39;re handled, and the outline rail shows an open-comment count on each section so nothing hides.</p>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/review-rounds.png" alt="The Review rounds drawer: a color team select reading Pink, a due date, an Add round button, and an existing Pink round with one comment and a Planned status" width="560" height="292" loading="lazy" decoding="async" /><figcaption>A round moves from Planned to In progress to Complete.</figcaption></figure>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/review-mode.png" alt="A section in Review mode: the Review toggle selected, the drafted text on the left, and a Comments sidebar on the right with a comment box, a severity select reading Should, and an Add button" width="826" height="800" loading="lazy" decoding="async" /><figcaption>Highlight a span, pick a severity, pin the comment to it.</figcaption></figure>
<p>We&#39;d suggest keeping the severities honest. A Must is something that would lose the bid or fail compliance. If everything is a Must, the submission package will block on all of it, which is the right behaviour but a miserable afternoon.</p>
<h2 id="ai-review">AI review</h2>
<p><strong>AI review</strong> runs the same exercise with the AI as reviewer. Choose a pass: <strong>Pink</strong> checks a first draft for compliance and completeness, <strong>Red</strong> reads as a skeptical evaluator for persuasiveness and win themes, and <strong>Gold</strong> does a final executive polish. Click <strong>Run review</strong> and the AI reads each written section and leaves anchored comments in a new round of that color, pinned to the exact text like a human reviewer&#39;s. If it finds nothing, it says so rather than inventing feedback.</p>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/ai-review.png" alt="The AI review drawer: a short explanation, a select reading Pink first-draft compliance and completeness, and a Run review button" width="560" height="274" loading="lazy" decoding="async" /><figcaption>Pick a color, run it, and the comments land in a round of that color.</figcaption></figure>
<p>One person gets the benefit of a review team. That&#39;s the point of this feature, and it&#39;s why we run it on our own proposals in the order Pink, Red, Gold, with a real human reading between passes.</p>
<h2 id="turning-comments-back-into-text">Turning comments back into text</h2>
<p>Two tools convert feedback into edits, and both leave you in control.</p>
<p><strong>AI: propose a fix</strong> works on a single comment. It drafts a replacement for the commented span, and accepting it writes a new version of the section.</p>
<p><strong>Evaluate comments &amp; regenerate</strong> works at section scale. The AI reads the section&#39;s current text plus every open comment and rewrites the whole section. The result appears as a proposed revision beside the current text, and nothing changes until you click <strong>Accept revision</strong> (written as a new AI version) or <strong>Reject</strong>. If you edit the section after generating, Cairn asks you to re-run, so the AI is always working from your latest text rather than a stale copy. The button is disabled while the editor has unsaved changes for the same reason.</p>
<h2 id="the-sf-424-cover-sheet">The SF-424 cover sheet</h2>
<p>For grant submissions, the rail has an <strong>SF-424 cover sheet</strong> entry. The SF-424 is the standard cover form for federal grant applications. Cairn auto-seeds it from your company profile and the opportunity, and it renders as the cover sheet in your export and in any Grants.gov filing. <strong>Re-populate from profile</strong> refreshes the auto-filled fields after you&#39;ve changed the profile.</p>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/sf-424-cover-sheet.png" alt="The Grant application SF-424 drawer: a note that it is auto-seeded from the company profile and the opportunity, Re-populate from profile and Save cover sheet buttons, and the cover sheet fields from applicant legal name and EIN through funding opportunity number, assistance listing number, and estimated funding" width="780" height="883" loading="lazy" decoding="async" /><figcaption>Seeded from your profile and the notice. You fill in the rest.</figcaption></figure>
<p>Two fields deserve a note. The <strong>Assistance listing (CFDA) number</strong> is the five-digit code identifying the exact federal grant program, such as 93.243; it&#39;s on the funding opportunity, and the CFDA title is that program&#39;s official name. And estimated funding has three parts: federal is what you&#39;re requesting from the agency, applicant is your organization&#39;s own contribution or cost-share match, and total is the two combined. Enter your match even when the program doesn&#39;t require one.</p>
<h2 id="the-submission-package">The submission package</h2>
<p><strong>Submission package</strong> assembles everything into one ready-to-file bundle, with a checklist standing between you and a mistake.</p>
<p>The ZIP contains the proposal as both DOCX and PDF, the compliance checklist, the SF-424 cover sheet for grants, the bid-decision summary from the scorecard, your approved past performance, your attachments under an attachments folder, and a manifest documenting completeness. <strong>Download package</strong> gets you the same ZIP the header&#39;s <strong>Export</strong> button does.</p>
<p><strong>Attachments</strong> is where budgets, narratives, resumes, and letters go, each in a slot (Narrative, Budget, Resume, SF-424 form, or Other). The feature we&#39;re proudest of here is small: you can declare a required item before its file exists, with <strong>Add required item</strong>. Readiness will then block until something is actually attached, which is what stops a known-missing document from being forgotten under deadline pressure.</p>
<h3 id="the-readiness-checklist">The readiness checklist</h3>
<figure><img src="/blog/img/proposal-writer-part-2-review-and-submission/submission-package.png" alt="The Submission package drawer: a Not ready chip, a readiness list with green, red, and amber marks for sections drafted, compliance matrix, required attachments, solicitation linked, review comments, and bid/no-bid scorecard, an attachments row with a slot select, a required checkbox, and Upload file, an Add required item box, and Download package and Approve all documents buttons" width="780" height="410" loading="lazy" decoding="async" /><figcaption>Red stops you. Amber only warns.</figcaption></figure>
<p>Two severities, and only one of them stops you.</p>
<p>Blocking checks, shown in red, must be resolved before final approval: open compliance items, empty sections, missing required SF-424 fields, required attachments with no file, unresolved Must comments, and a missing solicitation. Warnings, shown in amber, are advisory: Should and Consider comments, pending AI revisions you haven&#39;t accepted or rejected, and no P-win recorded on the scorecard.</p>
<p>The header&#39;s readiness chip summarises the same list, so you can watch blockers count down without opening the drawer.</p>
<h3 id="final-approval">Final approval</h3>
<p><strong>Approve all documents &amp; info for submission</strong> is an explicit human sign-off. You&#39;re attesting that every document and field has been reviewed. The button stays disabled until every blocking check passes, and until then it explains what&#39;s still open. Approving freezes the submission at <strong>Final</strong> and notifies the pursuit&#39;s assignee that it&#39;s ready to submit. A submission moves through four states: Draft while it&#39;s being written, Final once approved, Submitted once filed, and Abandoned if the pursuit is dropped.</p>
<h2 id="filing-with-grants-gov">Filing with Grants.gov</h2>
<p>For grants on the Enterprise plan, Cairn can file directly through the Grants.gov System-to-System (S2S) API, transmitting the SF-424 generated from your cover sheet plus every attached file. After approval, a <strong>Submit to Grants.gov</strong> button appears; it shows a confirmation listing the passed checks and the attachments about to be transmitted, and <strong>Confirm &amp; submit</strong> sends it. The tracking number and processing status (Received, then Validated) then appear in the package, with a refresh control.</p>
<p>This needs setup, because Grants.gov requires each applicant to submit through its own Authorized Organization Representative. The credential lives on the company profile, in the <strong>Grants.gov submission</strong> card:</p>
<ol>
<li>In Grants.gov, have your AOR request S2S access and obtain your organization&#39;s S2S certificate.</li>
<li>Export it as a PKCS#12 file (.pfx or .p12) with a password. This is the mTLS client certificate tied to your AOR-enrolled account.</li>
<li>Upload the file and enter its password in Cairn. It&#39;s stored encrypted and never shown again; upload a new file only to replace or renew it.</li>
<li>Select the <strong>Test</strong> environment first, validate a real submission end to end, then switch to <strong>Production</strong>.</li>
</ol>
<p>The Test environment is Grants.gov&#39;s applicant acceptance environment: it validates a real application without filing it. Only switch to Production once a Test submission has succeeded, because Production files for real. <strong>Enable S2S submission</strong> is the master switch for your company; automated filing is attempted only when it&#39;s on and a certificate is uploaded, and turning it off pauses automated filing without deleting your certificate. The sender ID field is optional and only needed if Grants.gov or the agency gave you one.</p>
<p>Until S2S is set up, or on plans without it, Cairn gives you guided manual instructions instead: download the package, sign in to Grants.gov Workspace as the AOR, complete the SF-424 from the cover sheet in the ZIP, upload the narrative and attachments, then record the tracking number in the pursuit&#39;s notes. Contract submissions follow the solicitation&#39;s own instructions: upload the DOCX or PDF and the attachments where the agency says, record the confirmation in the pursuit&#39;s running notes, and move the card to <strong>Submitted</strong>.</p>
<p>That&#39;s the whole path, from a search result in <a href="/blog/working-the-capture-pipeline">the pipeline post</a> to a filed application. The pieces that feel strict, the approval gate and the blocking checks, are the ones that have saved us the most.</p>
<h2 id="questions-people-ask">Questions people ask</h2>
<h3 id="what-blocks-final-approval">What blocks final approval?</h3>
<p>Six things: open compliance items, empty sections, missing required SF-424 fields, required attachments with no file, unresolved Must comments, and a missing solicitation. Should and Consider comments, pending AI revisions, and a missing P-win only produce amber warnings. The approve button becomes available the moment every blocking check passes.</p>
<h3 id="can-cairn-submit-a-contract-proposal-to-sam-gov-for-me">Can Cairn submit a contract proposal to SAM.gov for me?</h3>
<p>No. Automated filing is available only for grants, through the Grants.gov System-to-System API on the Enterprise plan. For a contract, Cairn assembles the package and gives you step-by-step instructions to submit it the way the solicitation specifies, then you record the confirmation and move the pursuit to Submitted.</p>
<h3 id="what-is-in-the-exported-zip">What is in the exported ZIP?</h3>
<p>The proposal as both DOCX and PDF, the compliance checklist, the SF-424 cover sheet for grants, the bid-decision summary from the scorecard, your approved past performance, your attachments in a folder, and a manifest documenting completeness. Download package in the submission drawer and Export in the header produce the same bundle.</p>
<h3 id="do-i-need-an-aor-certificate-to-use-the-submission-package">Do I need an AOR certificate to use the submission package?</h3>
<p>No. The package, its readiness checklist, and final approval work on every plan that includes the workspace, and manual filing instructions are always available. The AOR-enrolled S2S certificate is needed only for automated Grants.gov filing, which is an Enterprise feature, and it is uploaded on the company profile under Grants.gov submission.</p>]]></content:encoded>
    </item>
    <item>
      <title>The proposal writer, part 1: sources, the shred, and first drafts</title>
      <link>https://cairnfed.ai/blog/proposal-writer-part-1-sources-shred-drafts</link>
      <guid isPermaLink="true">https://cairnfed.ai/blog/proposal-writer-part-1-sources-shred-drafts</guid>
      <pubDate>Wed, 09 Sep 2026 12:00:00 GMT</pubDate>
      <category>Proposals</category>
      <category>AI drafting</category>
      <category>Compliance</category>
      <description>How a proposal starts in Cairn, what the AI reads before it writes, how the shred builds your compliance matrix and outline, and how drafting works.</description>
      <content:encoded><![CDATA[<p>We wrote the proposal workspace around one belief: the AI should do the busywork and the first draft, and a person should own every sentence that ships. Everything below follows from that. The AI drafts into a new version rather than over your text, it can&#39;t insert a source you didn&#39;t approve, and nothing it proposes is written to the proposal until you say so.</p>
<p>The workspace is part of the Professional and Enterprise plans. This post is the front half of the workflow; <a href="/blog/proposal-writer-part-2-review-and-submission">part two</a> covers compliance, review rounds, and the submission package.</p>
<h2 id="where-a-proposal-comes-from">Where a proposal comes from</h2>
<p>Most proposals in Cairn start themselves. When a pursuit advances into the <strong>Proposal in Progress</strong> stage, Cairn queues an automatic first draft: it creates the submission, picks an outline for a contract or a grant, runs a compliance pre-pass over the solicitation&#39;s attachments, and drafts every section from the gathered pursuit data and your company profile. The workspace header shows <strong>AI draft queued</strong> and then <strong>AI drafting sections</strong> while that runs, and each section fills in as it finishes. If a draft fails partway, you get a <strong>Retry AI draft</strong> button rather than a silent gap. Once it&#39;s done, <strong>Regenerate draft</strong> will redo every section into a new AI version; your current content stays in version history.</p>
<p>The manual route works too. Open a pursuit from the pipeline, go to its <strong>Tools</strong> tab, and under <strong>Proposal</strong> click <strong>Create proposal</strong>. Either way you land in the workspace at <strong>Deliver › Proposals</strong>, where the list shows every submission with its status chip, its due date, and a progress bar reading &quot;6 of 9 sections drafted&quot;.</p>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/proposals-list.png" alt="The Proposals list: each submission with its solicitation number, a Draft status chip, its title, a due-date chip, and a progress bar such as 6 of 6 sections drafted" width="1376" height="576" loading="lazy" decoding="async" /><figcaption>Every submission, where it stands, and how much of it is written.</figcaption></figure>
<h2 id="the-workspace-at-a-glance">The workspace at a glance</h2>
<p>A sticky header carries the title, the status chip (Draft, Final, Submitted, or Abandoned), the due date with a days-left count, a readiness chip that reads <strong>Ready</strong>, <strong>Not ready</strong>, or the number of blockers, and an <strong>Export</strong> button that downloads the whole thing as a ZIP.</p>
<p>Down the left is the rail, in three groups. <strong>Outline</strong> lists every section with a state dot (Drafted, AI drafting now, Outline seed, or Not started) and a word count. <strong>Workspace</strong> opens the compliance matrix, AI review, review rounds, the SF-424 cover sheet for grants, and the submission package. <strong>Sources</strong> opens the solicitation and shred card and your context documents.</p>
<p>The middle is the document itself, one continuous canvas with a <strong>Draft with AI</strong> strip at the top and each section as a numbered block.</p>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/workspace.png" alt="The proposal workspace: the sticky header with status, due date, a blockers chip, and Export, the outline rail on the left with Outline, Workspace, and Sources groups, and the document canvas showing a drafted Executive Summary" width="1440" height="900" loading="lazy" decoding="async" /><figcaption>Header, rail, canvas. The rail's word counts and state dots update as you work.</figcaption></figure>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/outline-rail.png" alt="The outline rail: six sections with green dots and word counts, then Compliance matrix, AI review, Review rounds, and Submission package, then Solicitation and shred and Context documents" width="262" height="459" loading="lazy" decoding="async" /><figcaption>Everything in the rail is one click from the document.</figcaption></figure>
<h2 id="set-up-sources-first">Set up sources first</h2>
<p>The first time you open a fresh proposal, the Sources drawer opens on its own with the title <strong>Set up sources</strong>. Take the thirty seconds. This is where you tell the AI what it may read.</p>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/set-up-sources.png" alt="The Set up sources drawer on a fresh proposal: the shred card, then a guided note explaining the Content source and Style guide roles above the company's document list, with a Continue without documents button at the bottom" width="560" height="853" loading="lazy" decoding="async" /><figcaption>The guided first run. It only appears until you have set sources up once.</figcaption></figure>
<p>Context documents are reference material from your company: past proposals, writing samples, standard language. Each file is uploaded once for your whole company (it also appears in the Library under Content as a &quot;Context document&quot;), and each new proposal just ticks the boxes for the documents it should draw on. Then you give every selected document one of two roles:</p>
<ul>
<li><strong>Content source</strong>: the AI draws facts, capabilities, and evidence from it.</li>
<li><strong>Style guide</strong>: the AI matches its tone, structure, and formatting, and won&#39;t copy its facts.</li>
</ul>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/sources.png" alt="The Sources drawer: the Solicitation analysis card with its upload button, then the Context documents card listing two uploaded PDFs, each with a checkbox and a Content source or Style guide toggle, and a Rebuild voice profile button" width="560" height="683" loading="lazy" decoding="async" /><figcaption>Each selected document plays one of two roles.</figcaption></figure>
<p>That split is the part we&#39;d ask you to think about. A past proposal that won is a great style guide and a risky content source, because its facts belong to a different customer and a different year. A current capability statement is the reverse. Marking the roles keeps the AI from quoting last year&#39;s staffing plan into this year&#39;s bid.</p>
<p>The whole set of context documents does something broader: it teaches Cairn your company&#39;s voice profile, a distilled picture of your tone, structure, and phrasing. The profile refreshes when a document finishes processing, and there&#39;s a <strong>Rebuild voice profile</strong> button in the card. It captures style only. The AI never copies facts or client names out of your samples.</p>
<p>If you have nothing to add yet, <strong>Continue without documents</strong> closes the drawer and remembers that you chose to. You can come back any time from <strong>Context documents</strong> in the rail. One detail: a context document that isn&#39;t approved in the Library shows a <strong>Paused</strong> chip here, and the AI won&#39;t read it until someone approves it.</p>
<h2 id="shred-the-solicitation">Shred the solicitation</h2>
<p>Now the government&#39;s document. In the same drawer, the card titled <strong>Solicitation analysis (&quot;shred&quot;)</strong> takes the RFP or funding notice as a PDF, DOCX, TXT, or MD file. Upload it with <strong>Upload the RFP / funding notice</strong>, then click <strong>Build matrix &amp; outline (shred)</strong>.</p>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/solicitation-shred.png" alt="The Solicitation analysis card: a note that it is for the government's document only, and an Upload the RFP or funding notice button" width="523" height="135" loading="lazy" decoding="async" /><figcaption>The government's document goes here. Your own material goes in Context documents.</figcaption></figure>
<p>&quot;Shred&quot; is capture jargon for tearing the document apart line by line so that no requirement is missed. The run produces two things: a compliance matrix of every requirement it found, and a proposed section outline for your response. Don&#39;t upload your own reference material here; that belongs in context documents, and mixing the two is the most common way to get a confused outline.</p>
<p>The shred deliberately pauses partway through and shows you the proposed outline. Approve it as-is or edit the section list first. Nothing is written to your proposal until you approve, and if a teammate is assigned to the pursuit, they&#39;re notified that an outline is waiting for review.</p>
<p>No solicitation to shred? Start from a standard outline instead. The picker offers <strong>Federal contract (UCF volumes)</strong>, which seeds Executive Summary, Technical Approach, Management Approach, Staffing &amp; Key Personnel, Past Performance, and Cost/Price Volume, or <strong>Federal grant (narrative + SF-424)</strong>, which seeds the standard grant narrative sections from Statement of Need through Budget Narrative. Each section arrives with a short purpose note as its first version (the rail marks it <strong>Outline seed</strong>), and you can add, rename, reorder, or remove sections from the block menu.</p>
<h2 id="drafting">Drafting</h2>
<p>There are three ways to get words into a section, and they compose.</p>
<p><strong>Draft with AI</strong> on a single section writes it grounded in your company profile, your approved past performance, your saved content, and the context documents you selected. The result is saved as a new version tagged AI, so machine text stays distinguishable from your edits and you can roll back to any earlier version from <strong>History</strong>.</p>
<p><strong>Draft N sections</strong>, in the strip at the top of the canvas, first-drafts every section that&#39;s still empty. Sections you&#39;ve already written, or that have a pending AI revision waiting for your decision, are skipped. It will not overwrite your work. That rule is absolute, and it&#39;s why the button says how many sections it&#39;s about to touch.</p>
<p><strong>Edit &amp; comment</strong> opens the section editor. In Edit mode you write Markdown in a plain textarea, and the toolbar above it holds the AI actions for a selection: highlight some text and choose <strong>Improve</strong>, <strong>Tighten</strong>, <strong>Expand</strong>, or <strong>Align to win themes</strong>, or pick a requirement from <strong>Address requirement…</strong> to rewrite the selection so it answers that row of the compliance matrix. The AI rewrites just the selection and drops it back in place, and nothing is saved until you click <strong>Save</strong>.</p>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/section-editor.png" alt="A section block with the editor open: an Edit and Review mode toggle, a version chip reading V6 AI, a History button, the AI edit selection toolbar with Improve, Tighten, Expand, and Align to win themes, the Markdown textarea, a Comments sidebar, and Save and Evaluate comments and regenerate buttons" width="826" height="435" loading="lazy" decoding="async" /><figcaption>The version chip says whether the current text is an AI draft or yours.</figcaption></figure>
<figure><img src="/blog/img/proposal-writer-part-1-sources-shred-drafts/section.png" alt="A drafted section on the canvas: the number 01, the heading Executive Summary, a Drafted chip, and the opening paragraphs of the draft" width="826" height="720" loading="lazy" decoding="async" /><figcaption>Sections read as one document; hover a block for its tools.</figcaption></figure>
<p>Each drafted section shows a footer with its version number, whether it&#39;s an AI draft or human text, its word count, how many requirements it covers, and when it was last updated. Restoring an older version is one click from History.</p>
<h2 id="what-the-ai-reads-and-what-feeds-it">What the AI reads, and what feeds it</h2>
<p>The quality of a draft tracks the quality of what the AI can see. Three things feed it. Your company profile, especially the capability narrative. Your Library, which holds past performance write-ups (marked prime or subcontractor, because evaluators weigh the two differently) and approved reusable content: win themes, boilerplate, resumes and bios, strong passages lifted from past proposals, and the context documents above. And the pursuit itself, including whatever the Intelligence tab gathered from the notice.</p>
<p>The Library has one gate worth understanding: a new asset is a draft, and the AI ignores it. Approving an asset with <strong>Approve for AI</strong> indexes it into your company&#39;s private search store, and only then can a draft retrieve and cite it. The badge reads <strong>Approved · indexed</strong> when that&#39;s true. This gate exists so unreviewed language can&#39;t find its way into a proposal by accident. A small library of your best language produces better drafts than a large one of mediocre content, so approve selectively.</p>
<p>That gets you from an empty submission to a drafted document with a compliance matrix behind it. <a href="/blog/proposal-writer-part-2-review-and-submission">Part two</a> picks up from there: working the matrix, running review rounds, and getting the package ready to file.</p>
<h2 id="questions-people-ask">Questions people ask</h2>
<h3 id="will-the-ai-overwrite-something-i-wrote">Will the AI overwrite something I wrote?</h3>
<p>No. Draft with AI saves its output as a new version tagged AI, so your text stays in history and you can restore it. Draft all sections only touches sections that are still empty and skips anything you&#39;ve written or anything with a pending AI revision. Selection edits change nothing until you click Save.</p>
<h3 id="what-s-the-difference-between-a-context-document-and-the-solicitation">What&#39;s the difference between a context document and the solicitation?</h3>
<p>The solicitation is the government&#39;s document, the RFP or funding notice you&#39;re responding to, and the shred turns it into your compliance matrix and outline. Context documents are your own material, such as past proposals and writing samples, which ground the AI&#39;s drafts and teach it your voice. Upload each in its own card; mixing them produces a confused outline.</p>
<h3 id="which-plan-includes-the-proposal-workspace">Which plan includes the proposal workspace?</h3>
<p>The workspace, the solicitation shred, AI drafting, and AI review are part of the Professional and Enterprise plans. On Starter the Proposals page shows the feature locked with an upgrade prompt, and after an upgrade it opens right away with your existing pipeline untouched.</p>
<h3 id="can-i-start-a-proposal-without-an-rfp">Can I start a proposal without an RFP?</h3>
<p>Yes. When there is no solicitation to shred, apply a standard outline instead: Federal contract seeds the Uniform Contract Format volumes, and Federal grant seeds the standard narrative sections plus the SF-424 cover sheet. Each section arrives with a purpose note, and you can add, rename, reorder, or remove sections before drafting.</p>]]></content:encoded>
    </item>
    <item>
      <title>Working the pipeline: from a search result to a bid decision</title>
      <link>https://cairnfed.ai/blog/working-the-capture-pipeline</link>
      <guid isPermaLink="true">https://cairnfed.ai/blog/working-the-capture-pipeline</guid>
      <pubDate>Wed, 02 Sep 2026 12:00:00 GMT</pubDate>
      <category>Pipeline</category>
      <category>Find Opportunities</category>
      <category>Bid/no-bid</category>
      <description>How we run capture in Cairn: search both federal registries, add a pursuit, read the card, score the bid/no-bid decision, and move it one stage at a time.</description>
      <content:encoded><![CDATA[<p>A pipeline stays useful only while it reflects reality. Most of the design decisions in this part of Cairn exist to keep that true: a search that shows you what you can&#39;t bid instead of hiding it, a board where moving a card is a recorded decision, and a scorecard that produces a number you can defend three months later. This post follows one opportunity through all of it.</p>
<h2 id="find-it">Find it</h2>
<p>Open <strong>Capture › Find Opportunities</strong>. One search covers both federal registries, contract opportunities from SAM.gov and grant funding opportunities from Grants.gov, and the two source pills let you switch either one off. Results are merged and de-duplicated, so a notice that appears in more than one place shows once, keeping its highest fit score, and each result carries a badge for where it came from.</p>
<p>Type keywords for the work you do and search. The <strong>Use company profile</strong> pill is on by default; it&#39;s what ranks the results against your profile rather than returning them in the order the registries did.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/find-opportunities.png" alt="The Search Federal Opportunities band: a keyword box, a Search button, SAM.gov and Grants.gov source pills, and the Use company profile pill" width="1376" height="204" loading="lazy" decoding="async" /><figcaption>One search, both registries, ranked against your profile.</figcaption></figure>
<p>The filter bar narrows by NAICS (up to five codes), set-aside (Total Small Business, 8(a), WOSB, SDVOSB, HUBZone), state of performance, and due window (30, 60, or 90 days). Here is the single most important thing to know on this page: those structured filters only narrow SAM.gov results. Grants.gov opportunities don&#39;t carry those fields, so grants are matched on your keywords alone, and the filters never constrain them. The page says so in small print, and we&#39;ll say it again here because it surprises everyone once.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/search-filters.png" alt="The filter bar: NAICS chips with an add box, a set-aside select, a state select, a due window select, the expired and very old listings toggle, Clear all, and sort controls" width="1376" height="99" loading="lazy" decoding="async" /><figcaption>These filters narrow SAM.gov results only.</figcaption></figure>
<p>By default Cairn hides anything whose deadline has passed, plus anything posted more than two years ago. A Grants.gov opportunity can stay &quot;posted&quot; for years, and without the age cut-off stale listings crowd out live ones. Toggle <strong>Include expired &amp; very old</strong> to see them; those results are chipped <strong>Expired</strong> or <strong>Very old</strong>.</p>
<h3 id="reading-a-result">Reading a result</h3>
<p>Every result has a fit score from 0 to 100 and a <strong>Why it fits</strong> list explaining it. The score reads your NAICS and PSC codes, your set-aside certifications, your target agencies, and your capability narrative. It&#39;s triage, not a verdict.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/search-result.png" alt="A result card: a fit shield reading 55, the title, the agency, a SAM.gov badge, the NAICS code and posted date, a Why it fits list, and Add to Pipeline and View notice buttons" width="1376" height="208" loading="lazy" decoding="async" /><figcaption>Why it fits explains the score in plain terms.</figcaption></figure>
<p>Results you can&#39;t bid are greyed but kept visible, and a high-fit result your certifications bar you from gets an explicit <strong>Ineligible</strong> flag. We flag rather than hide on purpose. A strong fit score shouldn&#39;t nudge you toward work you&#39;re not permitted to win, and seeing what you&#39;re locked out of is useful information about which certifications would open doors.</p>
<p>The value figure means different things by source. For a contract it&#39;s the government&#39;s estimated total value of the work. For a grant it&#39;s the funding ceiling, the most a single award can be. Either way it&#39;s the official estimate, not a promise.</p>
<p>The results line reads something like &quot;12 matches · from ~40 notices&quot;. Matches is what you&#39;re seeing after de-duplication and your filters. The larger number is the approximate total the sources reported before local filtering.</p>
<p>When something looks worth a closer read, click <strong>Add to Pipeline</strong>. It lands in <strong>Identified</strong>, the first stage, ready to qualify.</p>
<h2 id="two-other-ways-in">Two other ways in</h2>
<p>Search isn&#39;t the only intake. The dashboard&#39;s <strong>Top Matches</strong> card lists recently captured opportunities ranked against your profile, each with an <strong>Add</strong> button. And on the Professional plan, <strong>Capture › Recompete Radar</strong> runs a weekly sweep of expiring federal awards in your NAICS codes and target agencies, so you can position for the follow-on before the solicitation drops; <strong>Add to pipeline</strong> on a candidate creates the pursuit and saves a snapshot of the award with it. There&#39;s no free-text &quot;add an opportunity by hand&quot; path. Every pursuit starts from a real notice or a real award, which is what lets the rest of the product read the source document.</p>
<h2 id="the-board">The board</h2>
<p><strong>Capture › Pipeline</strong> is a board: columns are capture stages, cards are pursuits, and moving a card is a decision you&#39;re recording. The stages run left to right: <strong>Identified</strong>, <strong>Qualifying</strong>, <strong>Pursuing</strong>, <strong>Proposal in Progress</strong>, <strong>Submitted</strong>. After that a pursuit reaches a terminal outcome, <strong>Won</strong>, <strong>Lost</strong>, or <strong>No-bid</strong>, and drops off the active board into a collapsed <strong>Closed</strong> strip at the end, where Won outcomes get a gold chip. Closed pursuits no longer count against your active-pursuit limit. To reopen one, move it back to an active stage.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/closed-strip.png" alt="The Closed strip expanded below the board, with Won, Lost, and No-bid counts and a row for each closed pursuit" width="1376" height="145" loading="lazy" decoding="async" /><figcaption>Closed pursuits keep their history and stop counting against the active limit.</figcaption></figure>
<figure><img src="/blog/img/working-the-capture-pipeline/pipeline-board.png" alt="The pipeline board with five stage columns, Identified through Submitted, and cards showing agency, due date, value, a Contract or Grant chip, an Enriched chip, a fit badge, and an Advance button" width="1376" height="1411" loading="lazy" decoding="async" /><figcaption>A red edge means the deadline is inside the critical window.</figcaption></figure>
<p>A card shows the title, agency, due date, value, a Contract or Grant chip, a fit badge, and an <strong>Advance</strong> button. Two colour cues are worth learning: a red edge means the deadline is overdue or inside the 14-day critical window, and a gold edge marks a high-fit pursuit. A <strong>New</strong> chip marks anything added in the last seven days. The <strong>Board</strong> and <strong>Table</strong> toggle at the top switches to a sortable table when you&#39;d rather scan by due date or value.</p>
<h2 id="open-the-card">Open the card</h2>
<p>Click a card and the pursuit drawer opens with four tabs.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/pursuit-overview.png" alt="The pursuit drawer on the Overview tab: the opportunity title, agency, type, due date, and fit, the fact grid, the Why it fits list, and the stage dock pinned at the bottom" width="720" height="774" loading="lazy" decoding="async" /><figcaption>Four tabs, and the stage dock always in reach.</figcaption></figure>
<p><strong>Overview</strong> is the opportunity fact grid: agency, type, NAICS, set-aside, response due, a link to the official listing, and the fit score with its <strong>Why it fits</strong> reasons.</p>
<p><strong>Intelligence</strong> is where the AI does some homework. Click <strong>Sync</strong> and Cairn gathers a summary, key facts, the source documents attached to the notice, points of contact, and links, then shows when it last synced and how many sources it read. This is the tab we&#39;d open first on anything that scored well.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/pursuit-intelligence.png" alt="The Intelligence tab: AI-gathered details marked Enriched, a summary of the notice, response deadline, eligibility, estimated value, set-aside, and a Sync button" width="720" height="774" loading="lazy" decoding="async" /><figcaption>Sync reads the notice and its attachments so you do not have to.</figcaption></figure>
<p><strong>Tools</strong> changes with the stage. Early on it holds the bid/no-bid scorecard and the gate review. Once a pursuit reaches the proposal stage it adds the proposal launcher, and at the end the submission package.</p>
<p><strong>Activity</strong> is the pursuit&#39;s log: every stage move, every note, tagged by who made it (you from the app, the assistant from chat, or the system).</p>
<figure><img src="/blog/img/working-the-capture-pipeline/stage-dock.png" alt="The stage dock: a numbered stepper across the five active stages with Identified marked current, Close out chips for Won, Lost, and No-bid, an optional reason box, and an Advance to Qualifying button" width="720" height="144" loading="lazy" decoding="async" /><figcaption>Every move is recorded with whatever reason you type.</figcaption></figure>
<p>Pinned to the bottom of the drawer is the stage dock: a numbered stepper across the active stages with the current one marked, the terminal chips under <strong>Close out</strong>, a note box for an optional reason, and an <strong>Advance to …</strong> button. You can also move a card backward to any earlier stage, and we&#39;d encourage it. A pursuit that needs more qualification than it got, or a solicitation that changed enough to reset your thinking, belongs back in Qualifying. Every move is recorded in the activity log with whatever note you typed, so the board&#39;s current state always has a history behind it.</p>
<h2 id="score-the-decision">Score the decision</h2>
<p>The bid/no-bid scorecard is the structured version of the go/no-go conversation. Six weighted criteria: capability fit, incumbent position, agency relationship, past-performance relevance, resources and capacity, and competitive landscape. You score each from 0 to 10 and write a short justification.</p>
<figure><img src="/blog/img/working-the-capture-pipeline/scorecard.png" alt="The bid/no-bid scorecard in the Tools tab: a P-win ring, a Research evidence with AI button, and the Capability fit criterion with its description, a suggested 6 out of 10, a 0 to 10 score row, and a justification box" width="680" height="1181" loading="lazy" decoding="async" /><figcaption>AI suggestions arrive as drafts you accept or ignore.</figcaption></figure>
<p>It produces two things worth having. The first is a <strong>P-win</strong>, a probability of win that&#39;s a deterministic weighted roll-up of your scores. The same inputs always produce the same number; there&#39;s no black-box model in the middle. Only the criteria you actually score count toward it, and unscored criteria are excluded rather than silently treated as zero. The second is an auditable record of why you chose to bid or pass, which is exactly what you want when someone asks about it a quarter later.</p>
<p>On Professional, <strong>Research evidence with AI</strong> reads the pursuit and your profile, suggests a score for each criterion with its reasoning, and marks those entries with an <strong>AI draft</strong> badge. The suggestion is a draft. You own the number, and we built the badge so nobody mistakes the two.</p>
<h2 id="gate-reviews">Gate reviews</h2>
<p>A gate review is a capture-discipline checkpoint. When a stage has its gate turned on, you must record a <strong>bid</strong>, <strong>no-bid</strong>, or <strong>defer</strong> decision, with an optional rationale, before any pursuit can advance into it. The point is to force a deliberate go/no-go. Without a gate, pursuits drift forward one small step at a time and you discover at proposal time that nobody ever actually decided to bid.</p>
<p>Gates are off by default. Turn them on per stage under <strong>Company › Team</strong>, on the <strong>Pipeline</strong> tab. Most teams gate the entry to Pursuing, to Proposal in Progress, or both. Then, in the drawer&#39;s Tools tab, the <strong>Gate review</strong> panel takes the decision and <strong>Record gate review</strong> files it.</p>
<h2 id="a-working-rhythm">A working rhythm</h2>
<p>Three habits keep the board honest. Qualify early and no-bid honestly: a no-bid recorded with a justification is a better outcome than a pursuit that quietly stalls in Qualifying for a quarter. Score the scorecard before the gate review, not during it. And let the terminal stages do their job, because closing pursuits is what keeps the active board an accurate picture of the work in front of you.</p>
<p>When a pursuit does advance into Proposal in Progress, Cairn starts the proposal for you. That&#39;s <a href="/blog/proposal-writer-part-1-sources-shred-drafts">the next post</a>.</p>
<h2 id="questions-people-ask">Questions people ask</h2>
<h3 id="can-i-add-an-opportunity-by-hand">Can I add an opportunity by hand?</h3>
<p>No. Every pursuit starts from a real notice or award: a result in Find Opportunities, an entry in the dashboard&#39;s Top Matches, or a candidate promoted from Recompete Radar. That&#39;s what lets the rest of the product read the source document, gather intelligence, and shred the solicitation later.</p>
<h3 id="do-the-naics-set-aside-and-state-filters-apply-to-grants-gov-results">Do the NAICS, set-aside, and state filters apply to Grants.gov results?</h3>
<p>No. Those structured filters only narrow SAM.gov contract results, because Grants.gov opportunities don&#39;t carry those fields. Grants are matched on your keywords alone, and your organization type on the company profile is what determines which grants you&#39;re eligible for.</p>
<h3 id="what-happens-when-i-close-a-pursuit-as-won-lost-or-no-bid">What happens when I close a pursuit as Won, Lost, or No-bid?</h3>
<p>It leaves the active board for the collapsed Closed strip at the end, stops counting against your plan&#39;s active-pursuit limit, and keeps its full activity log. Won outcomes are marked with a gold chip. To reopen a closed pursuit, move it back to an active stage; reopening counts it against the limit again.</p>
<h3 id="how-is-the-p-win-calculated">How is the P-win calculated?</h3>
<p>It&#39;s a deterministic weighted roll-up of the scores you enter on the bid/no-bid scorecard, using each criterion&#39;s weight. The same inputs always produce the same number, only criteria you actually scored count, and unscored criteria are excluded rather than treated as zero. An AI-suggested score is a draft until you accept it.</p>]]></content:encoded>
    </item>
    <item>
      <title>Your company profile, and why auto-fill from SAM.gov comes first</title>
      <link>https://cairnfed.ai/blog/company-profile-and-sam-gov</link>
      <guid isPermaLink="true">https://cairnfed.ai/blog/company-profile-and-sam-gov</guid>
      <pubDate>Wed, 26 Aug 2026 12:00:00 GMT</pubDate>
      <category>Company profile</category>
      <category>SAM.gov</category>
      <category>Getting started</category>
      <description>A field-by-field walk through the Cairn company profile: auto-fill from SAM.gov, the API key you need, NAICS and PSC codes, certifications, and the narrative.</description>
      <content:encoded><![CDATA[<p>Every new account gets pointed at the company profile before it sees anything else, and every empty dashboard we&#39;ve ever been asked about traced back to a profile that was still blank. Fit scores, the dashboard&#39;s top matches, the weekly recompete sweep, and every AI draft read from this one page. So this post takes it slowly, field by field, in the order we&#39;d fill it in.</p>
<p>Open <strong>Company › Company Profile</strong>. The page has an auto-fill hero at the top, then four sections: <strong>Identity</strong>, <strong>Capabilities &amp; targeting</strong>, <strong>SAM.gov API key</strong>, and, for grant applicants, <strong>Grants.gov submission</strong>.</p>
<h2 id="start-with-auto-fill-from-sam-gov">Start with auto-fill from SAM.gov</h2>
<p>Type your UEI into the box under <strong>Auto-fill from SAM.gov</strong> and click <strong>Auto-fill</strong>. Cairn calls SAM.gov and pulls your legal name, CAGE code, address, registration status, NAICS and PSC codes, and the set-aside certifications on your registration.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/auto-fill-from-sam-gov.png" alt="The Auto-fill from SAM.gov hero at the top of the company profile: a UEI input and an Auto-fill button" width="1376" height="91" loading="lazy" decoding="async" /><figcaption>Auto-fill takes a 12-character UEI and reads the rest from SAM.gov.</figcaption></figure>
<p>Two things we want you to know about how this works. Auto-fill only touches the fields SAM.gov returns, so anything you&#39;ve typed into other fields stays put. And nothing is saved until you review the result and click the save button at the bottom, so you can run it, look, and back out.</p>
<p>Once SAM.gov data is in, a status strip shows whether your registration is <strong>Active</strong> (eligible to receive federal awards) and when it expires unless renewed. Both refresh each time you auto-fill, and the bell in the top band warns you as the expiry date approaches. Letting a SAM.gov registration lapse is the most avoidable way to lose an award, so we made sure the app nags about it.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/registration-status.png" alt="The status strip under the hero: SAM registration, registration expires, last synced, whether a tenant SAM.gov key is configured, and when that key expires" width="1376" height="75" loading="lazy" decoding="async" /><figcaption>The strip refreshes each time you auto-fill, and the bell warns before anything lapses.</figcaption></figure>
<h2 id="identity">Identity</h2>
<figure><img src="/blog/img/company-profile-and-sam-gov/identity.png" alt="The Identity section: legal business name, UEI, CAGE code, EIN, and DBA names" width="1376" height="278" loading="lazy" decoding="async" /><figcaption>The EIN field never shows a stored value. It reads Encrypted at rest.</figcaption></figure>
<p>Four identifiers live here. The UEI is the 12-character Unique Entity Identifier assigned in SAM.gov; it replaced the DUNS number in 2022, and the one you enter must match your registration exactly. The CAGE code is the 5-character Commercial and Government Entity code from that same registration, which agencies use to identify your business on contracts and payments; auto-fill sets it, so you&#39;ll rarely type it. The EIN is your 9-digit IRS tax ID, stored encrypted at rest and used only to match your entity. It never appears in searches or exports. And DBA names are trade names you operate under besides your legal name, comma-separated, so awards and opportunities recorded under those names still match you.</p>
<h2 id="capabilities-and-targeting">Capabilities and targeting</h2>
<p>This section is what fit ranking reads. We&#39;d give it more attention than any other part of the page.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/capabilities-and-targeting.png" alt="The Capabilities and targeting section: NAICS chips with the first marked Primary in gold, then NAICS codes, PSC codes, set-aside certifications, target agencies, contract size, organization type, the Recompete radar checkbox, and the capabilities narrative" width="1376" height="553" loading="lazy" decoding="async" /><figcaption>Everything fit ranking reads lives in this one section.</figcaption></figure>
<p>NAICS codes classify what your business does; PSC codes classify what the government is buying. Both fields take a comma-separated list. The first NAICS code you list is flagged as your primary and shown as a gold chip. It&#39;s your headline classification for fit ranking, so put your most representative code first, not the one you happened to register first.</p>
<p>List the certifications you hold under <strong>Set-aside certifications</strong>: 8(a), WOSB, HUBZone, SDVOSB, and so on. Auto-fill sets these from your registration. Listing them is what lets fit ranking surface set-aside work you can actually bid, and it&#39;s also what lets Cairn flag a high-fit notice as <strong>Ineligible</strong> when your certifications bar you from it.</p>
<p>Agencies you name under <strong>Target agencies</strong> get extra weight in fit ranking, and Recompete Radar watches them for expiring awards. Comma-separated, and as specific as you can make them.</p>
<p>Under <strong>Contract size</strong>, give a minimum and maximum dollar band. Opportunities well below or well above it rank as weaker fits. Be honest here. A band that runs from nothing to everything tells the ranker nothing.</p>
<p>Pick your <strong>Organization type</strong>: it&#39;s your applicant type for federal grants, whether small business, nonprofit 501(c)(3), state or local government, tribal, higher education, and so on. Grants.gov restricts many funding opportunities to specific applicant types, so this one field decides which grants you&#39;re eligible for.</p>
<p>The last item in the section is the <strong>Recompete radar</strong> checkbox. Turn it on and Cairn runs a weekly sweep of expiring federal awards in your NAICS codes and target agencies, so you can position for the follow-on before the solicitation drops. It&#39;s part of the Professional plan.</p>
<h2 id="the-capability-narrative">The capability narrative</h2>
<p>A plain-language description of what your company does, your past performance, and what sets you apart. The AI reads it both when scoring fit and when drafting proposals, so it&#39;s worth writing properly rather than pasting a tagline from your website.</p>
<p>If you&#39;d rather not start from a blank box, <strong>Generate with AI</strong> drafts one for you. Click it and pick a source: <strong>Website</strong> (a URL, and we&#39;ll read the page), <strong>Document</strong> (a capability statement or brochure as PDF, Word, an image, or text, up to 10 MB), or <strong>Paste text</strong>. Click <strong>Generate narrative</strong>, then edit what comes back before you save. The source you provide isn&#39;t stored. AI drafting is included in the Professional plan; on Starter the button reads <strong>Generate with AI: upgrade</strong> and takes you to the subscription page.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/generate-with-ai.png" alt="The Generate with AI panel open above the capabilities narrative, with Website, Document, and Paste text source buttons, a URL box, and Cancel and Generate narrative buttons" width="1334" height="308" loading="lazy" decoding="async" /><figcaption>Pick a source, generate, then edit before you save.</figcaption></figure>
<p>There&#39;s an <strong>Additional context</strong> box below the narrative for anything else that should inform fit and the assistant. Unusual past performance, a niche you&#39;re moving into, a customer you&#39;d rather not work for: this is the place.</p>
<h2 id="your-sam-gov-api-key">Your SAM.gov API key</h2>
<p>This section trips people up, so here&#39;s the whole story.</p>
<p>Auto-fill and opportunity search run against SAM.gov, and SAM.gov meters access with API keys. A personal key runs those calls on your own rate limits instead of a shared pool, which is why a key is required to save your profile. It&#39;s stored encrypted and never shown again; leave the field blank on later visits to keep the key you already saved.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/sam-gov-api-key.png" alt="The SAM.gov API key section: a masked API key field reading unchanged, and a Key expires date with a note about the 90-day estimate" width="1376" height="336" loading="lazy" decoding="async" /><figcaption>A saved key is never displayed again. Leave the field blank to keep it.</figcaption></figure>
<p>To get one:</p>
<ol>
<li>Go to SAM.gov and sign in. You&#39;ll need a Login.gov account, so create one if prompted.</li>
<li>Select your name in the top-right corner, then choose <strong>Account Details</strong>.</li>
<li>Scroll to the <strong>API Key</strong> section.</li>
<li>Click <strong>Request API Key</strong> and re-enter your password if asked.</li>
<li>Copy the generated key. It&#39;s shown only once, so store it somewhere safe.</li>
<li>Paste it into the <strong>API key</strong> field in Cairn and click <strong>Save changes</strong>.</li>
</ol>
<p>So that setup works immediately, new accounts borrow a shared starter key for a short period. Once that period ends, opportunity search and saved-search alerts need a key of your own. Filling in your profile from SAM.gov keeps working either way, so you&#39;re never locked out of finishing the profile, and you&#39;ll see a reminder before starter access ends.</p>
<h3 id="when-the-key-expires">When the key expires</h3>
<p>SAM.gov keys stop working roughly 90 days after they&#39;re created, and SAM.gov doesn&#39;t publish the exact date through its API. So we estimate the expiry when you save a key and remind you as it approaches: two weeks out, then again in the last few days. If SAM.gov showed you a different date, correct it in the <strong>Key expires</strong> field and the reminders follow the stored date.</p>
<p>An expired key is still sent to SAM.gov, because the date is only our estimate and the key may well still work. If it doesn&#39;t, you&#39;ll see errors from SAM.gov. Request a new key, paste it in, and save; saving a new key resets the expiry.</p>
<h2 id="save-and-what-happens-next">Save, and what happens next</h2>
<p>The button at the bottom reads <strong>Create profile</strong> the first time and <strong>Save changes</strong> after that. On save, the &quot;Finish your company profile&quot; banner disappears across the app, and from then on new captures are scored against what you entered.</p>
<p>If you&#39;ll be filing grants through Cairn, the <strong>Grants.gov submission</strong> card at the bottom of the page is where the AOR certificate goes. That&#39;s an Enterprise feature and a topic of its own, so we cover it in <a href="/blog/proposal-writer-part-2-review-and-submission">part two of the proposal writer guide</a>.</p>
<figure><img src="/blog/img/company-profile-and-sam-gov/grants-gov-submission.png" alt="The Grants.gov submission card: a certificate file picker for a .pfx or .p12 file, a certificate password, an optional sender ID, an environment select reading Test, an Enable automated submission checkbox, and a Save Grants.gov settings button" width="1376" height="315" loading="lazy" decoding="async" /><figcaption>The certificate is stored encrypted and never displayed again.</figcaption></figure>
<p>One habit worth forming: come back to this page when something real changes. A new certification, a new target agency, a narrative that finally says what you do now rather than three years ago. The ranker can only be as good as the profile it reads.</p>
<h2 id="questions-people-ask">Questions people ask</h2>
<h3 id="what-if-my-sam-gov-registration-is-about-to-expire">What if my SAM.gov registration is about to expire?</h3>
<p>Cairn shows your registration status and expiry date in the strip under the auto-fill hero, both refreshed each time you auto-fill, and the notification bell warns you as the date approaches. Renewing happens on SAM.gov itself; once you&#39;ve renewed, run auto-fill again to pull the new status and date into your profile.</p>
<h3 id="does-auto-fill-overwrite-what-i-ve-already-typed">Does auto-fill overwrite what I&#39;ve already typed?</h3>
<p>No. Auto-fill only fills the fields SAM.gov returns, so your own edits to other fields stay untouched, and nothing is saved until you review the result and click Save changes. If you don&#39;t like what came back, leave the page without saving and your stored profile is unchanged.</p>
<h3 id="why-is-one-of-my-naics-codes-shown-in-gold">Why is one of my NAICS codes shown in gold?</h3>
<p>The first NAICS code you list is your primary code, and the gold chip marks it. It&#39;s your headline classification for fit ranking, so put your most representative code first. The order of the rest doesn&#39;t matter.</p>
<h3 id="do-you-keep-the-website-or-document-i-give-generate-with-ai">Do you keep the website or document I give Generate with AI?</h3>
<p>No. The source you provide for the narrative, whether a URL, an uploaded document, or pasted text, is read to draft the narrative and isn&#39;t stored. What gets saved is the narrative text you review and keep, in your company profile.</p>]]></content:encoded>
    </item>
    <item>
      <title>Getting started with Cairn: from sign-up to your first pursuit</title>
      <link>https://cairnfed.ai/blog/getting-started-with-cairn</link>
      <guid isPermaLink="true">https://cairnfed.ai/blog/getting-started-with-cairn</guid>
      <pubDate>Wed, 19 Aug 2026 12:00:00 GMT</pubDate>
      <category>Getting started</category>
      <category>Company profile</category>
      <category>Pipeline</category>
      <description>How we'd spend your first hour in Cairn. Create a free account, fill in the company profile, run one search across SAM.gov and Grants.gov, and add a pursuit.</description>
      <content:encoded><![CDATA[<p>We built Cairn to make federal capture a repeatable process: find the right opportunities, decide deliberately whether to bid, and turn the ones you pursue into submitted proposals. This post is the short version of the first hour. If you only do one thing today, make it the company profile. We&#39;ll explain why as we go.</p>
<h2 id="create-your-account">Create your account</h2>
<p>Sign-up is plan first. Go to <a href="/signup">cairnfed.ai/signup</a>, fill in your name, email, and a password on the <strong>Create your account</strong> form, and click <strong>Continue</strong>. You&#39;ll land on <strong>Choose Your Plan</strong>. Pick <strong>Starter</strong> (it&#39;s free) and click <strong>Get Started</strong>. The account is only created once you&#39;ve confirmed a plan, which is why there&#39;s no &quot;confirm your email later&quot; limbo.</p>
<figure><img src="/blog/img/getting-started-with-cairn/create-your-account.png" alt="The Create your account form on cairnfed.ai, with first name, last name, username, email, and password fields" width="1040" height="936" loading="lazy" decoding="async" /><figcaption>Sign-up starts with the account form. The plan comes next.</figcaption></figure>
<figure><img src="/blog/img/getting-started-with-cairn/choose-your-plan.png" alt="The Choose Your Plan step of sign-up, showing the Starter and Professional cards with their features, limits, and buttons" width="1040" height="560" loading="lazy" decoding="async" /><figcaption>Pick Starter to begin free. The account is created only after a plan is chosen.</figcaption></figure>
<p>Starter covers fit-ranked search and the pipeline. Professional adds the AI toolkit: the assistant, the proposal workspace, AI drafting, Recompete Radar, and team seats. You can start free and upgrade later without losing anything; a feature outside your plan shows as locked rather than hidden, so you can see what&#39;s there before paying for it. Current prices are on the <a href="/#l-pricing">home page</a>.</p>
<p>After the plan step, Cairn sends you straight to the company profile. That&#39;s deliberate.</p>
<h2 id="fill-in-your-company-profile-first">Fill in your company profile first</h2>
<p>A brand-new account has a mostly empty dashboard, and the reason is always the same: nothing has been scored yet, because there&#39;s no profile to score it against. Fit scores, the dashboard&#39;s top matches, the weekly recompete sweep, and AI drafting all read from this one page. Until it&#39;s filled in, Cairn shows a banner that says <strong>Finish your company profile.</strong> on every page, with a <strong>Complete profile</strong> button. We put that banner there on purpose. It&#39;s the one nag in the product.</p>
<p>Here&#39;s the fast path:</p>
<ol>
<li>Open <strong>Company › Company Profile</strong>.</li>
<li>Type your 12-character UEI into the box at the top and click <strong>Auto-fill</strong>. Cairn pulls your legal name, CAGE code, address, registration status, NAICS and PSC codes, and set-aside certifications straight from SAM.gov. Nothing is saved until you review it and click the save button, so you can look before you commit.</li>
<li>Add what SAM.gov doesn&#39;t know about you: your target agencies, your typical contract size, your organization type (this is what decides which grants you&#39;re eligible for), and a capability narrative that says what you actually do.</li>
<li>Paste in a SAM.gov API key and click <strong>Create profile</strong>.</li>
</ol>
<p>That last step surprises people, so a word on it. The API key is required to save the profile, because auto-fill and opportunity search run against SAM.gov on your own rate limits rather than a shared pool. New accounts borrow a shared starter key for a short period so nothing blocks you on day one, and you&#39;ll see a reminder before that access ends. Requesting your own takes a couple of minutes on your SAM.gov account details page. <a href="/blog/company-profile-and-sam-gov">The company profile post</a> walks through every field and the key, including what happens when a key expires.</p>
<p>The capability narrative deserves more than a tagline. The AI reads it when scoring fit and when drafting proposals, so a plain paragraph about what you do, who you&#39;ve done it for, and what sets you apart pays back everywhere. On Professional, <strong>Generate with AI</strong> will draft a first version from your website, a capability statement, or pasted text, and you edit from there.</p>
<h2 id="run-your-first-search">Run your first search</h2>
<p>Open <strong>Capture › Find Opportunities</strong>. One search covers both federal registries: contract opportunities from SAM.gov and grant funding opportunities from Grants.gov. Type a few keywords for the kind of work you do, keep both source pills on, and search.</p>
<p>Every result carries a fit score from 0 to 100 and a short <strong>Why it fits</strong> list. The score is how well the notice matches your profile: your NAICS and PSC codes, the set-aside certifications you hold, your target agencies, and your narrative. Treat it as triage rather than a verdict. It tells you what to read first, and clicking a title opens the official notice at its source so you&#39;re always reading the government&#39;s own posting.</p>
<p>Two things worth knowing on this page. First, the structured filters (NAICS, set-aside, state, due window) only narrow SAM.gov results, because Grants.gov opportunities don&#39;t carry those fields. Grants are matched on your keywords alone. Second, a high-fit result your certifications bar you from gets an explicit <strong>Ineligible</strong> flag instead of quietly disappearing. We&#39;d rather show you a strong match you can&#39;t bid than have the score nudge you toward work you&#39;re not permitted to win.</p>
<p>When something looks promising, click <strong>Add to Pipeline</strong>. The button changes to <strong>Added to Pipeline</strong> and the opportunity becomes a pursuit.</p>
<h2 id="add-a-pursuit-and-look-at-the-board">Add a pursuit and look at the board</h2>
<p>A new pursuit arrives in <strong>Identified</strong>, the first capture stage, and shows up on the board under <strong>Capture › Pipeline</strong>. The stages run left to right: Identified, Qualifying, Pursuing, Proposal in Progress, Submitted. Then a pursuit closes as Won, Lost, or No-bid.</p>
<p>Each card has an <strong>Advance</strong> button, and opening a card shows four tabs: <strong>Overview</strong> (the opportunity facts), <strong>Intelligence</strong> (AI-gathered details once you click <strong>Sync</strong>), <strong>Tools</strong> (the bid/no-bid scorecard and, later, the proposal and submission package), and <strong>Activity</strong> (every move and note, with a history behind it). Moving a card is a decision you&#39;re recording, not a drag on a whiteboard, which is why every move lands in the activity log.</p>
<p>We cover qualifying, the scorecard, and gate reviews in <a href="/blog/working-the-capture-pipeline">the pipeline post</a>. For day one, adding one real pursuit is enough to make the rest of the product light up.</p>
<h2 id="read-the-dashboard">Read the dashboard</h2>
<p>The dashboard answers one question: what deserves attention today. Four tiles across the top: <strong>Active Pursuits</strong> (everything not yet Won, Lost, or No-bid), <strong>Est. Pipeline Value</strong> (the estimated dollar value of every active pursuit, summed straight up and not weighted by win probability), <strong>Avg Fit Score</strong>, and <strong>Due This Month</strong>. Anything due within 14 days counts as critical and turns red across the whole app.</p>
<figure><img src="/blog/img/getting-started-with-cairn/dashboard.png" alt="The Cairn dashboard: a greeting strip with the fiscal quarter, four tiles for Active Pursuits, Est. Pipeline Value, Avg Fit Score, and Due This Month, then a Top Matches card and an Upcoming Deadlines card" width="1376" height="774" loading="lazy" decoding="async" /><figcaption>The dashboard once a profile and a few pursuits exist.</figcaption></figure>
<p>Below the tiles, <strong>Top Matches</strong> lists recently captured opportunities ranked against your profile, each with an <strong>Add</strong> button, and <strong>Upcoming Deadlines</strong> lists what&#39;s due on active pursuits. The date box on the right shows the federal fiscal year and quarter, because federal buying follows that calendar rather than the civilian one. If Top Matches is empty, go back to the profile: new captures are only scored once there&#39;s a profile to score them against.</p>
<h2 id="ask-the-assistant-and-click-the-little-icons">Ask the assistant, and click the little icons</h2>
<p>The floating button in the bottom-right corner opens the Cairn Assistant. It knows which page you&#39;re on, so &quot;why is this ranked so low?&quot; works without you explaining the context, and it can research opportunities or update pursuits for you. One guarantee we hold to: it never changes your data on its own. When it wants to add, update, or delete something, it pauses, lists each proposed action, and waits for your approval. The assistant is part of the Professional plan; on Starter the panel stays locked.</p>
<p>Small info icons sit next to fields and headings throughout the app. Click one for a short explanation of that specific thing. Each page also has a <strong>Page tour</strong> button in the breadcrumb strip that replays its guided walkthrough, and the full product documentation lives under <strong>Docs</strong> in the top menu once you&#39;re signed in.</p>
<p>That&#39;s the first hour. Profile, one search, one pursuit. Everything else in Cairn builds on those three.</p>
<h2 id="questions-people-ask">Questions people ask</h2>
<h3 id="is-there-a-free-plan">Is there a free plan?</h3>
<p>Yes. Starter is free and covers fit-ranked search across SAM.gov and Grants.gov plus the capture pipeline. Professional adds the AI assistant, AI drafting, the proposal workspace, Recompete Radar, and team seats, and Enterprise is unlimited usage with priority support and automated Grants.gov submission. Current prices are always shown on the home page.</p>
<h3 id="do-i-need-my-own-sam-gov-api-key-on-day-one">Do I need my own SAM.gov API key on day one?</h3>
<p>No. New accounts borrow a shared starter key for a short period, so auto-fill and search work immediately. Once that period ends, opportunity search and saved-search alerts need a key of your own, which you request from the API Key section of your SAM.gov account details page. Filling in your profile from SAM.gov keeps working either way, and Cairn reminds you before starter access ends.</p>
<h3 id="can-my-teammates-work-in-the-same-workspace">Can my teammates work in the same workspace?</h3>
<p>Yes. Pursuits belong to your company rather than to one person, so everyone sees the same pipeline. Team collaboration is part of the Professional and Enterprise plans, and seats come with the plan: ten on Professional, unlimited on Enterprise. You add people from Company › Team, either by creating their account directly with Add user or by sending them a single-use invite token.</p>
<h3 id="is-there-a-mobile-app">Is there a mobile app?</h3>
<p>A Cairn companion app for iPhone is on its way to the App Store. It signs in with the same account, shows the same live pipeline, and carries your ranked matches and deadline alerts, and there is nothing extra to buy. Create your account on the web first; the app has no sign-up screen of its own.</p>]]></content:encoded>
    </item>
  </channel>
</rss>
