govcon-pursuit-brain is the public GovCon pursuit method layer: domain
knowledge, schemas, conventions, playbooks, validators, and pursuit
workflows. This document explains how to pair the public method with your
company's private context so the package works for your specific business.
Roughly 40% of pursuit value can live in an open-source method layer. The other 60% is company-specific and accumulated through use.
| Public method layer (this package) | Private company context (yours) |
|---|---|
| FAR / DFARS / CFR orientation | Your customer relationships |
| Solicitation structure (UCF, L/M/C) | Incumbent pain, customer politics |
| Source-selection mechanics | Your past performance and CPARS history |
| Bid/no-bid frameworks | Leadership appetite, B&P tolerance |
| Capture playbook (Black Hat, PTW, win themes) | Your discriminators, what you can credibly claim |
| Proposal craft (compliance matrix, color teams) | Your proposal team capacity, voice, doctrine |
| CMMC / FedRAMP / NIST 800-171 basics | Your actual compliance posture and gaps |
| Protest and debrief mechanics | Your prior debrief lessons |
| Public-source research patterns (SAM, USAspending) | Your CRM, internal sales intel, relationship maps |
| Synthetic example pursuits | Your real pursuits (kept private) |
The public method teaches a disciplined GovCon team how to think. The private context teaches the method what is true for this company.
Keep this in a private repository or controlled workspace. Never put it in this public package.
company-context/
customers/ # the agencies and program offices you actually serve
past-performance/ # your approved past-performance library, with CPARS
key-personnel/ # your bench, clearances, availability, commitments
partners/ # teaming history, exclusivity, mentor-protégé status
pricing-guidance/ # wrap rates, indirect ranges, fee posture, PTW rules
compliance-posture/ # your CMMC, FedRAMP, NIST 800-171, ITAR/EAR state
debrief-lessons/ # what you learned losing or winning recent pursuits
approved-proof-points/ # validated claims you may make in proposals
pursuits/ # active pursuits (also git-ignored by this package)
The pursuits/ directory at the root of this public package is already
git-ignored. That protects pursuit-level data when you use the package
in-place. Your broader company-context belongs in a separate location
under your organization's control.
See ../schema/company-context.template.md
for the per-folder structure, entity types, frontmatter, and sensitivity
rules.
Every skill in this package follows the same pattern when private company context is available:
- Read the public method (domain wiki, conventions, schema).
- Read the company-context: if a
company-context/(or--company-contextargument) is configured, read it before intake. - Skip intake questions whose answers are in company-context. If the company's pricing-guidance already covers indirect rates, the skill does not ask the user to retype them. The skill cites the company-context source on the resulting entity pages.
- Augment the pursuit wiki with company-context-derived entities. For example, an approved past-performance reference from
company-context/past-performance/lands inpursuits/<id>/entities/past-performance/for the pursuit, with itssourcetagged to the company-context page andconfidencepropagated. - Never copy company-context into the public package. The company-context stays in the company's private repository or workspace; the pursuit wiki references it.
Without a configured company-context/, skills fall back to user intake.
The method still works, just with less leverage. The package is genuinely
useful without private context; it is more useful with it.
Avoid "company brain." It overclaims and implies an enterprise knowledge system. Use the language below for your private-context layer:
- "Customize for Your Company"
- "Adapt This to Your Company"
- "Using Private Company Context"
- "Company Customization"
- "Customize to Your Company's Needs"
The repo here is named for the pursuit brain (the per-pursuit compounding knowledge graph), which is what the architecture actually builds. Per-pursuit memory compounds across one bid; company-context compounds across a company's portfolio. Both are needed; neither is "the company brain."
Many of the things that decide a pursuit do not live in clean artifacts:
- who the customer actually trusts
- incumbent pain and incumbent vulnerability
- bid/no-bid politics inside the company
- leadership appetite and B&P tolerance
- proposal team capacity
- SME usability and availability
- real proof quality vs. boilerplate
- pricing realism (what you can actually bid, not just PTW)
- amendment blast radius across the pursuit
- color team closure quality
- relationship gaps
- teaming politics
- whether the capture plan has momentum or is just words
The pursuit-wiki entity model includes types for each. See the entities
added in v0.2.2: incumbent-pain/, capture-momentum/,
decision-politics/, team-capacity/, proof-points/,
pricing-reality/, amendment-impact/, review-closure/, and
relationship-map/. Most of those entities draw on company-context in
addition to the public solicitation.
The sensitivity tag on every entity page enforces the boundary:
- Company-context entities normally carry
sensitivity: company-proprietary. - Customer-meeting notes may rise to
sensitivity: source-selection-sensitiveif they reflect non-public evaluation information. See../conventions/tagging.mdand../knowledge/integrity-and-ethics/procurement-integrity-act.md. - Competitor information from a competitor's protected sources is
sensitivity: competitor-proprietary, quarantined, not used. See../skills/analyzing-competitors/references/competitive-intelligence-ethics.md. - CUI, export-controlled, and classified material may only enter the workspace if the organization's policy and the applicable safeguarding rules permit it.
The scripts/validate_vault.py validator enforces sensitivity rules and
will warn on inappropriate combinations.
- Use the public package first. Run a pursuit through the public method with intake-based input. Get a feel for the entity model and the skills.
- Stand up a minimal
company-context/in a private repo. Start with the highest-leverage folders:past-performance/,key-personnel/,pricing-guidance/. The rest grows over time. - Configure the skills to read the company-context location (the per-pursuit
pursuit.mdschema includes acompany_context_path:field). - Let the company-context compound. Every pursuit produces lessons, reusable proof points, and debrief findings; promote the ones that generalize back into
company-context/. That is the value-multiplier the public method alone cannot deliver.
This package is an open-source GovCon pursuit framework that helps teams turn capture and proposal work into structured, evidence-backed, reusable pursuit knowledge.
It is not a complete company brain, a system of record, or a replacement for CRM, SharePoint, or proposal-management SaaS. It is the method layer that those systems' data can pour into and the agents the company already uses can read against.