Output files
When the report helper and write access are available, each skill writes a fixed filename family, so downstream skills (report-pdf, counsel-handoff, search-precedent) can find earlier results. Saved reports follow shared contract v1: each run gets its own folder under an approved output root, never beside the input documents or in the working directory's root, and an existing report is never overwritten.
reviews/
└── <fund>/
└── <date>/
└── <run-id>/
├── run.json
└── <subfolder>/
└── <report-id>/
├── <filename>
└── <filename>.jsonWithout the helper or required write access, the fallback is an UNVERIFIED chat draft, not a saved report. A completed report can be READY_FOR_REVIEW, PARTIAL or BLOCKED; none is operational approval.
run.json records the run; each report sits in its own folder next to a .json evidence sidecar that lists its sources with their SHA-256 hashes. Folders are created private to your user (0700) and files 0600; permissions on existing folders and backups remain the operator's responsibility. Hashes identify content, not authenticity. The <subfolder> depends on the kind of report:
| Folder | Filename families |
|---|---|
reports/ | LPA-REVIEW-…, PPM-REVIEW-…, SUBSCRIPTION-REVIEW-…, SIDE-LETTER-REVIEW-…, CAPITAL-CALL-REVIEW-…, DISTRIBUTION-REVIEW-…, CAPITAL-ACCOUNT-REVIEW-…, K1-REVIEW-…, POA-REVIEW-…, GP-UPDATE-REVIEW-…, DEED-REVIEW-…, COUNSEL-HANDOFF-…, TAX-REVIEW-…, INGEST-REPORT-…, EMAIL-INGEST-…, FUND-REVIEW-REPORT.pdf |
analysis/ | BENCHMARK-REPORT-…, WATERFALL-REVIEW-…, TERMS-EXTRACT-…, PLAIN-ENGLISH-…, FUND-COMPARISON-…, MULTI-DOC-ANALYSIS-…, TERMS-PLAYBOOK-…, PRECEDENT-SEARCH-…, NEGOTIATION-STRATEGY-…, ENTITY-MAP-…, RECONCILIATION-… |
drafts/ | CAPITAL-CALL-…, DISTRIBUTION-NOTICE-…, INVESTOR-LETTER-…, SIDE-LETTER-…, AMENDMENT-DRAFT-…, BOARD-MEMO-…, DDQ-RESPONSE-…, DATA-ROOM-…, AUDIT-SUPPORT-…, ESG-REPORT-… |
compliance/ | COMPLIANCE-REVIEW-…, KYC-REVIEW-…, AML-SCREENING-…, FATCA-CRS-CLASSIFICATION-…, INVESTOR-CLASSIFICATION-…, SUITABILITY-CHECK-…, SUBSCRIPTION-PROCESS-…, ONBOARDING-CHECKLIST-…, FILING-PREP-…, REGULATORY-CALENDAR-…, WIRE-VERIFY-… |
tracking/ | MFN-TRACKER-…, MFN-ELECTION-…, OBLIGATION-TRACKER-…, COVENANT-MONITOR-…, KYC-TRACKER-…, EMAIL-MONITOR-…, INGEST-MANIFEST-… |
analytics/ | PERFORMANCE-REPORT-…, CASHFLOW-FORECAST-…, SCENARIO-MODEL-…, FEE-AUDIT-…, WATERFALL-SIM-… |
portfolio/ | PORTFOLIO-DASHBOARD-… |
report-pdf writes FUND-REVIEW-REPORT.pdf into the same run. A skill called by another shares its parent's run ID and writes under its own report ID. Every command's page in this manual names its file, and catalog.json lists them for machines.
Placeholders in filenames are always [fund], [investor], [type] and [date]; [fund] is a slug of the fund name and [date] is the review date. Skills create runs and write reports with the packaged helper, fund_report.py new-run and write-report.
