BdM-15/capture-insights / skills/subcontractor-sow-builder
subcontractor-sow-builder
VerifiedDrafts a federally-defensible SOW or PWS the prime issues to a subcontractor / teaming partner — same FAR 37.102(d) / 37.602 / 16.601(c)(2) / 16.306(d) discipline a contracting officer applies, opposite seat. USE WHEN the user asks to "write a SOW for our sub", "draft a PWS for [Partner]", "build the teaming-partner statement of work", "convert this SOO into a sub SOW", "we need a SOW the sub will sign", or any variant of authoring a downstream work statement. Walks the upstream 3-phase tree (acquisition intake → 6 scope blocks → 14-section assembly), pulls scope from the active Theseus KG (requirements, deliverables, work_scope_items, performance_standards), enforces FAR 37.102(d) "no FTEs in body", emits a chat-only staffing handoff for the prime's cost build, writes Markdown for `renderers` → .docx. DO NOT USE FOR prime proposal prose (`proposal-generator`), reverse-engineering an RFP (`rfp-reverse-engineer`), pricing the sub (`price-to-win`), or clause audit (`compliance-auditor`).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.3 KB |
| UPSTREAM.md | markdown | 4.7 KB |
| evals/evals.json | config | 5.9 KB |
| references/decision_tree_blocks.md | markdown | 7.6 KB |
| references/far_citations.md | markdown | 9.4 KB |
| references/language_rules.md | markdown | 3.2 KB |
| references/sow_pws_section_structure.md | markdown | 10.1 KB |
references/far_citations.md
View on GitHub# FAR Citations — Subcontractor SOW/PWS Builder
This skill cites FAR sections drawn from the upstream `sow-pws-builder` and translated to the prime → sub seat. Always cite the specific subsection where one is given (e.g., 16.306(d)(2), not bare 16.306).
## Core Citations (used in nearly every run)
| FAR Cite | Topic | Where it appears in the SOW/PWS |
| ------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **37.102(d)** | Describe the requirement in terms of results, NOT hours or number of people | Drives the "no FTE counts in body" rule. Cited in Section 14 if any reduction language describes capabilities (compliant) vs FTE counts (non-compliant). |
| **37.602** | Performance-based acquisition (PBA) is the preferred method for acquiring services | Cited in Section 12 (PWS QASP basis) and Section 14 (intake rationale for PWS over SOW). |
| **46.401** | Government contract quality assurance | Cited in Section 12 alongside 37.602 as QASP basis. |
| **7.105** | Written acquisition plans — requirement description | Background reference for the prime's own contracts file. |
## Contract-Type Citations
| Contract Type | FAR Cite | Notes |
| -------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| FFP | **16.202** | Default for commercial services. No Section 5. |
| FFP commercial | **12.207** | Authorized contract type for commercial-item acquisitions under Part 12. |
| T&M | **16.601** with **(c)(2)** mandatory | Section 5 Labor Category Ceiling Hours table required. Never bare 16.601. |
| LH | **16.601** with **(c)(2)** mandatory | Same as T&M; Section 5 required. |
| CPFF completion form | **16.306(d)(1)** | Bounded deliverable; full fee on delivery. Section 1.1 explicit cite. |
| CPFF term form | **16.306(d)(2)** | Level of effort over period; fee earned across period. Section 1.1 explicit cite. **Default when unsure for R&D.** |
| CR (any) | **16.301-3** | Approved accounting system prereq before award. Cited in Section 14 as a sub-side prereq the prime must verify. |
| CPAF | **16.305** | Award fee plan separate doc. |
| CPIF | **16.404** | Share ratio + min/max fee. |
**Never** cite bare `FAR 16.306` for CPFF — always with `(d)(1)` or `(d)(2)`.
## Security & Safeguarding
| FAR / Reg Cite | Topic | Section |
| ---------------------------- | ------------------------------------------------------------ | ------------------------------------------- |
| **52.204-21** | Basic Safeguarding of Covered Contractor Information Systems | Section 9, unclassified contracts |
| **NIST SP 800-171** | Protecting CUI in nonfederal systems | Section 9, when CUI in scope |
| **EO 13526** | Classified National Security Information | Section 9, classified contracts |
| **NISPOM** (32 CFR Part 117) | National Industrial Security Program | Section 9, cleared facilities |
| **ICD 705** | Physical and technical security standards for SCIFs | Section 9, when SCIF accreditation required |
| **DD Form 254** | Contract Security Classification Specification | Section 9, ALL classified contracts |
## Travel & ODCs
| FAR Cite | Topic | Notes |
| --------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------- |
| **31.205-46** | Travel costs | Cited on the chat-only CLIN Handoff travel CLIN as "Cost-reimbursable (NTE); no fee". |
| **52.212-4** | Contract terms and conditions — commercial items | Section 9 / Section 14 for commercial subagreements. |
| **52.212-4(m)** | Termination for cause / cure notice | Acceptable Payment Consequence in Section 12 QASP. |
## Inspection & Acceptance (SOW Only)
For SOW documents, Section 12 retitled "Inspection and Acceptance" cites the FAR 52.246-series:
| FAR Cite | Topic |
| ------------ | --------------------------------------------- |
| **52.246-2** | Inspection of supplies — fixed price |
| **52.246-4** | Inspection of services — fixed price |
| **52.246-5** | Inspection of services — cost-reimbursement |
| **52.246-6** | Inspection — time-and-material and labor-hour |
## Key Personnel Substitution Clauses (CRITICAL — DO NOT use 52.237-2)
**FAR 52.237-2 is "Protection of Government Buildings, Equipment, and Vegetation".** It has NOTHING to do with Key Personnel substitution. Citing it as the Key Personnel clause is a common error and a red flag.
Use the agency-appropriate clause:
| Agency | Clause | Title |
| ------------------------ | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| NASA | **NFS 1852.237-72** | Access to Sensitive Information / Key Personnel substitution governance |
| DHS | **HSAR 3052.237-72** | Key Personnel or Facilities |
| HHS | **HHSAR 352.237-75** | Key Personnel |
| DoD | agency-specific DFARS supplement clause if applicable | varies |
| Generic / unknown agency | **FAR 52.237-3** | Continuity of Services — covers continuity obligations; leave Key Personnel substitution as contract-specific custom language |
**Never emit `FAR 52.237-2` as the Key Personnel substitution clause.**
## QASP / CPARS Boundary (CRITICAL)
- **QASP** is forward-looking, threshold-based, payment-binding (Section 12).
- **CPARS** (FAR 42.15) is post-performance evaluation with fixed rating categories (Exceptional / Very Good / Satisfactory / Marginal / Unsatisfactory) bound to CO judgment across the full factor set.
- **CPARS is NOT QASP-bindable.** Do NOT put CPARS rating words in the QASP Payment Consequence column. Use payment / contract-admin consequences instead (deductions, cure notices, re-performance, terminations, incentive fees on CPIF/award-fee only).
## Common Citation Traps (audit before write)
1. Bare `FAR 16.306` cited for CPFF (must be `(d)(1)` or `(d)(2)`).
2. `FAR 52.237-2` cited for Key Personnel substitution (wrong clause — see table above).
3. CPARS rating language (`Satisfactory`, `Exceptional`, etc.) appearing in Section 12 Payment Consequence column.
4. Bare `FAR 16.601` cited for T&M / LH without `(c)(2)` (which is the actual ceiling-hours authority).
5. Section 5 included for FFP or CR contracts (Section 5 is T&M/LH ONLY).
6. Section 5 table containing SOC codes or FTE counts (it's a ceiling-hours pricing mechanism, not staffing).
7. FTE counts, SOC codes, or staffing tables appearing anywhere in the document body or any appendix (FAR 37.102(d) violation).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |