Skip to content

sikkrasmus/company-index-framework

Repository files navigation

type meta
title Company Index
description An LLM-maintained, human-reviewed wiki that becomes the context layer for every AI agent in your GTM org.
owner rasmus@latentflows.com
last_reviewed 2026-04-21
Company Index, the intelligence layer for revenue orgs running AI agents

Company Index

The intelligence layer your GTM org needs before AI agents can do useful work.

A markdown-and-git framework for an LLM-maintained, human-reviewed wiki of your ICP, pricing, positioning, plays, and metric definitions. Every claim is cited. Every change is a pull request. Stale content is flagged, not silently rotted.

A framework you fork, not a product you log into. The filled content is one worked instance: B2B SaaS sales-assisted, $10 to $100M ARR. A different company shape lands on a different spine.


The problem

Your team already uses Claude, ChatGPT, Gemini, and Cowork across sales, marketing, and CS. Each tool reads from whatever context someone pastes into the prompt. That context lives in Slack threads, old Notion pages, and people's heads.

Output quality tracks context quality. Yours is scattered across half a dozen surfaces, which is why the agents read inconsistent ICPs, quote last quarter's pricing, and hallucinate positioning.

Wikis tried to fix this and failed. Humans had to update them on top of their real jobs, pages went stale within a quarter, and the team stopped trusting the surface. The wiki became a graveyard.

Note

Company Index changes the maintenance economics. LLMs draft updates from real source material. Humans review and approve via PR. Every page has a verified_until date. A weekly lint pass flags drift, contradictions, and expired content, then opens reconciliation PRs. The wiki maintains itself, and your agents finally have a corpus they can trust.


Pick your reading path

Tip

The repo is large because the framework is the product. Start in the row that matches you. Each path is 20 to 40 minutes of reading.

If you are Your goal Read in this order
CRO or RevOps leader
Deciding whether to invest
Understand the framework, the rollout, and what makes it hard. docs/01-WHY.md, then docs/03-IMPLEMENTATION.md for the rollout plan and the eight hard parts.
RevOps lead
Self-implementing
Fork the framework and run it for your org. PRINCIPLES.md, then docs/03-IMPLEMENTATION.md, then walk functions/sales/ as the worked function.
Engineer
Auditing the architecture
Verify the schema, governance, and retrieval model hold up. schema/, then ingestion/, then PRINCIPLES.md.

What is in the box

flowchart TD
    %% Define Styles
    classDef default fill:#fdfcf9,stroke:#1a1a1a,stroke-width:1.5px,color:#1a1a1a,font-family:serif;
    classDef warn fill:#fdfcf9,stroke:#b91c1c,stroke-width:1.5px,color:#b91c1c,font-family:serif;
    classDef storage fill:#fdfcf9,stroke:#1a1a1a,stroke-width:3px,color:#1a1a1a,font-family:serif;
    classDef faint fill:none,stroke:#9a9a9a,stroke-width:1.5px,stroke-dasharray: 4 4;
    classDef group fill:none,stroke:#dcd9d1,stroke-width:1px,stroke-dasharray: 4 4;

    %% Level 1: Ingestion Sources
    subgraph L1 [Raw Sources]
        direction LR
        S1["`**Platform landscape**<br/>crm · erp · gong<br/>stripe · slack · docs<br/><small>~100 tools, queried live</small>`"]
        S2["`**Work artifacts**<br/>playbooks · call synth<br/>reviews · postmortems<br/><small>authored by the team</small>`"]
    end
    style L1 fill:none,stroke:#9a9a9a,stroke-dasharray: 4 4,stroke-width:1.5px

    %% Level 2: Connectors & Processing
    subgraph L2 [Ingestion & Processing]
        direction TB
        subgraph C_modes [Connectors]
            direction LR
            C1["`**Live query**<br/>Cite platform data with *as_of:* timestamps.<br/>Never copied.`"]
            C2["`**Synthesis · PR**<br/>Summarize artifacts into markdown,<br/>opened as a PR.`"]
        end
        style C_modes fill:#fdfcf9,stroke:#1a1a1a,stroke-width:1.5px

        IA["`*core llm layer*<br/>**Intelligence agents**<br/>Multiple agents maintain the corpus. Synthesize inputs, score confidence, and open reconciliation PRs.`"]
        
        PR["`*human in the loop*<br/>**PR review gate**<br/>Reviewer sees diff plus citations plus confidence. Stage 1 is all-PR. Stage 2 opens auto-merge for low-risk classes.`"]:::warn

        C_modes --> IA
        IA -->|diff + cite| PR
    end
    style L2 fill:none,stroke:none

    %% Level 3: Storage & Maintenance
    subgraph L3 [Storage Layer]
        direction LR
        
        subgraph corpus [Git Corpus]
            direction TB
            GC1["`*Top-level directories*<br/>shared/ | functions/ | schema/ | sources/`"]
            GC2["`*Navigation trio*<br/>CLAUDE.md | index.md | log.md`"]
            GC1 ~~~ GC2
        end
        style corpus fill:#fdfcf9,stroke:#1a1a1a,stroke-width:3px

        LS["`*scheduled · weekly*<br/>**Lint service**<br/>Flags source drift, stale verification, contradictions. Opens reconciliation PRs.`"]
    end
    style L3 fill:none,stroke:none

    %% Level 4: Retrieval & Consumption
    subgraph L4 [Consumption]
        direction TB
        R["`*read-only*<br/>**Retrieval**<br/>Grep plus frontmatter filters. Reads index.md first, then drills into candidate pages and follows citations.`"]

        subgraph consumers [End Users]
            direction LR
            U1["`**Workflow agents**<br/>ai sdr · deal-desk<br/>rfp · forecasting<br/><small>autonomous + hitl</small>`"]
            U2["`**Humans via chat**<br/>claude · cowork<br/>chatgpt · gemini<br/><small>in-workflow queries</small>`"]
        end
        style consumers fill:none,stroke:#9a9a9a,stroke-dasharray: 4 4,stroke-width:1.5px
        
        R -->|via skill| U1
        R -->|ci show| U2
    end
    style L4 fill:none,stroke:none

    %% Main Vertical Flow Connections
    S1 -->|live query| C1
    S2 -->|doc ingest| C2
    PR -->|merge| corpus
    corpus -->|read-only| R

    %% Feedback Loops (using longer links to prevent breaking the vertical hierarchy)
    PR -.->|reject| IA
    corpus -.-|content hashes| LS
    LS -.-|opens PR| PR
Loading

Three layers

Layer What it holds Where
Raw sources Call summaries, deal reviews, contract excerpts, internal-doc snapshots. Hybrid in-repo and out-of-repo per a written policy. sources/
The wiki Seven shared components every function reads from, plus function-specific content. Motion and segment as frontmatter tags, not parallel directory trees. shared/, functions/
The schema The operating agreement between humans, LLMs, and reviewers. Frontmatter spec, page templates, citation rules. schema/

Three operations

Operation What happens Spec
Ingest Changes land via PR. Function heads commit in v1. Connectors arrive via the abstract pattern. ingestion/pr-workflow.md
Query Humans and agents retrieve via the ci CLI or native Read and Grep against markdown. Every page cites its sources. consumption/
Lint Weekly pass flags source drift, stale verification, and contradictions. Opens reconciliation PRs. Humans approve. ingestion/drift-detection.md

The seven shared components

Co-authored content every function reads from. Lives in shared/.

Component What it covers
icp/ Tiered ICP (A, B, C) with firmographics, triggers, disqualifiers.
personas/ Individual roles plus buying-committee configurations.
product-and-packaging/ SKUs, editions, add-ons.
pricing/ Price book, discount guardrails, usage meters.
positioning/ Value props, category narrative, elevator pitches.
competitive-intel/ Competitor profiles, win-loss patterns.
data-definitions/ MQL, SQL, ARR, NRR, CAC, payback. Opinionated and sourced.

The navigation trio

The three files that make retrieval deterministic.

File Role Maintained by
CLAUDE.md Routing map. Loaded by Claude Code or Cowork at session start. Hand-written
index.md Catalog of every page with a one-line summary. The agent reads this first. ci reindex
log.md Append-only audit trail of every merge, lint pass, and ingest event. Automation

Worked function

The Sales function: methodology, playbooks, frameworks, plays, battlecards, objections, tools-and-stack

functions/sales/ is filled end to end as the proof that the pattern generalizes. Inside you will find:

The other five functions (marketing, customer success, support, RevOps, finance/legal) are documented as one consolidated page in functions/FUTURE-FUNCTIONS.md. It describes what each would cover when filled, plus the fill pattern.


Where this gets hard

Important

Forking the repo takes a day. Filling it out for your company takes 8 to 12 weeks. The framework points at every hard problem and tells you what we have already thought through. The work that is left is yours.

Eight problems to plan for, documented in docs/03-IMPLEMENTATION.md:

  1. Source-system plumbing (HubSpot, Salesforce, Gong, Fathom, Stripe).
  2. PII at extraction.
  3. Schema design without over-engineering.
  4. Cold-start from an existing Confluence or Notion graveyard.
  5. Reviewer fatigue at scale.
  6. Conflict-resolution UX when two sources disagree.
  7. Trust calibration as auto-merge expands.
  8. Cost and volume management.

The same doc has the suggested four-phase rollout plan that sequences the work.


Consumption

The ci CLI wraps grep, find, and frontmatter filtering. Bash plus yq. Zero runtime install. Agents invoke it via the Bash tool.

ci list --type icp --motion sales-assisted
ci show shared/pricing/price-book
ci search "mid-market discount guardrail"
ci verify --all
ci reindex --check

Eleven commands, documented in consumption/cli/README.md. The skill definition in consumption/SKILL.md registers ci as the canonical retrieval path for Claude Code and Cowork.


Governance

Graduated trust: three maturity stages with an always-PR list of seven content classes that never auto-merge

Trust expands along two dimensions.

  • Maturity. Stage 1 (months 0 to 3) is 100% PR. Stage 2 (months 3 to 6) adds routine auto-merge for low-risk classes. Stage 3 (months 6+) adds multi-source consensus and pattern-matched autonomy.
  • Content type. Some classes always require a PR regardless of stage: ICP, pricing, packaging, legal, strategic positioning, page creation, page deletion.

Every change appends to log.md. Rollback is one git revert away. Full spec in ingestion/pr-workflow.md.


Limitations

This framework is honest about what it does not do.

  • It is a blueprint, not a product. You fork it, adapt it, and run it. There is no SaaS to log into.
  • It does not ship real connectors. The abstract pattern is the deliverable. Implementations are yours to build or fork from the community.
  • It does not cover every function on day one. Sales is filled end to end. The other five are described in functions/FUTURE-FUNCTIONS.md and follow the same fill pattern.
  • It assumes a reviewer pool. The PR workflow needs humans for the first 90 days. Without that pool, the wiki cannot earn trust to expand auto-merge.
  • It is opinionated about what stays out. No embeddings, no vector DB, no CMS, no database. The reasoning is in PRINCIPLES.md.

Repository structure

company-index-framework/
├── README.md                ← you are here
├── PRINCIPLES.md            ← eleven binding principles
├── CLAUDE.md                ← routing map, loaded by agents at session start
├── index.md                 ← catalog of every page (auto-generated)
├── log.md                   ← audit trail (auto-appended)
│
├── shared/                  ← seven co-authored components
├── functions/               ← function-specific content (sales filled, others described in FUTURE-FUNCTIONS.md)
├── sources/                 ← raw sources, hybrid in-repo / out-of-repo policy
│
├── schema/                  ← frontmatter, enums, section-label grammar, page templates
├── ingestion/               ← PR workflow, drift detection, connector pattern
├── consumption/             ← ci CLI and Claude Code skill definition
│
└── docs/                    ← narrative docs: why, architecture, implementation, agents in action

Credits


License

MIT. Fork it, ship it, change it.


Built by Rasmus Sikk at Latentflows.

Company Index · 2026

About

An open framework for an LLM-maintained knowledge base for GTM and RevOps teams. Schema, routing, conflict resolution, and worked examples. Foundation before agents.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors