Skip to content

workflow-init.md

Latest commit

 

History

History
71 lines (48 loc) · 2.29 KB

workflow-init.md

File metadata and controls

71 lines (48 loc) · 2.29 KB

Workflow: Initialize KaC Repository

When to use

User wants to set up a new Knowledge-as-Code knowledge base from scratch.

Process

Step 1: Understand the domain

Ask the user one question at a time:

  1. "What domain is this knowledge base for?" (marketing, product, HR, customer success, or a combination)
  2. "What are the most common outputs you need to generate?" (emails, proposals, job descriptions, etc.)
  3. "What existing knowledge do you have that we could convert?" (docs, decks, guides — handle via kac-convert workflow later)

Step 2: Create the directory structure

Create the following structure in the user's working directory or specified location:

knowledge/
├── foundations/
├── techniques/
└── README.md

Step 3: Generate the README

The README should include:

# [Organization/Project] Knowledge Base

Knowledge-as-Code repository. Structured domain knowledge for AI-assisted output generation.

## How this works

**Foundations** (in `foundations/`) are validated claims about reality: our customers, competitors, product, messaging, voice. They state what is true. They never instruct what to do.

**Techniques** (in `techniques/`) encode how to approach types of situations. They reference foundations and specify reasoning approaches, not templates.

**Outputs** are generated on demand from Foundations + Techniques + Context. They are never stored here.

## Available Modules

### Foundations
[List will grow as modules are added]

### Techniques
[List will grow as techniques are added]

## Review Cadence
| Module Type | Frequency |
|---|---|
| Competitive intelligence | Monthly |
| ICP and messaging | Quarterly |
| Product capabilities | Each significant release |
| Brand voice, culture | Semi-annually |

Step 4: Recommend starter modules

Based on the domain and common outputs, recommend 3-5 foundation files to create first. Prioritize by: which foundations would be referenced by the most outputs?

Typical starters for marketing/sales:

  • foundation-icp-[primary-segment].md
  • foundation-messaging-core.md
  • foundation-brand-voice.md
  • foundation-competitor-[top-competitor].md
  • foundation-product-capabilities.md

Offer to begin authoring the first foundation file immediately (switch to kac-author-foundation workflow).