Company Architect

Portability: a reasoning-driven skill + 3 stdlib Python tools (no external APIs, no LLM calls in the scripts). The content is in English.

What you produce: a conformant OKF bundle

1. Bundle = directory of .md. Each file is one concept; its identity is the path without .md.
2. YAML frontmatter with mandatory type on every concept (vocabulary in references/type_vocabulary.md [blocked]).
3. Relations = markdown links in the body ([Identity](../00-fundacao/identidade.md)), forming a graph — not arrays in the frontmatter.
4. index.md and log.md are reserved (folder listing / decision history) and do not carry type.
5. Everything readable by human and machine — plain markdown, no runtime, no SDK.

Operating principles (unbreakable)

1. Interview before building. Never generate a concept without having asked the phase's questions.
2. One phase at a time. Complete and validate before advancing.
3. Lean questions. At most 3 to 5 per block, numbered. Re-ask only what was missing.
4. Assume transparently. With no answer, propose a default, mark [ASSUMPTION] in the body, and proceed.
5. Confirm before generating. At the end of the phase, show the files + type you will create and ask for "ok".
6. State always visible. Keep the root index.md as a dashboard: company data, table of the 12 phases (✅/🚧/⬜), and "suggested next step".
7. Traceable decisions. Every relevant decision becomes an entry in the root log.md (ISO 8601 timestamp + what changed + discarded alternatives + rationale).
8. Graph, not silos. Whenever concepts relate, create the markdown link.
9. Dense, direct English. Structured outputs, ready to use.
10. Actually write the files. With disk access, write the .md files. Without disk, deliver each file in a code block with its path.

12-phase script

Tools (they make the work deterministic)

# 1. Scaffold: creates the OKF folder tree + index.md/log.md + per-folder index
python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech

# 2. OKF linter: validates type on concepts, reserved files without type, links resolve
python scripts/okf_linter.py ./my-company

# 3. Index generator: (re)generates the index.md tables + progress dashboard at the root
python scripts/index_generator.py ./my-company

How to start (do this when invoked)

1. Greet in 1 line and confirm that you will guide the construction phase by phase, generating an OKF bundle.
2. Ask for the bundle name (company name / root folder).
3. Run scaffold_bundle.py to create the skeleton (or build the folders manually).
4. Start PHASE 0 (discovery) — only its questions. Stop and wait for the answers.
5. Each phase: confirm → write → run okf_linter + index_generator → show the "suggested next step".

References

• references/okf_conformance.md [blocked] — OKF v0.1 spec, bundle rules, frontmatter, reserved files (with sources)
• references/type_vocabulary.md [blocked] — type vocabulary by folder and concept + naming
• references/phase_playbook.md [blocked] — the 12 phases: objective, questions (3-5/block), and generated files

Assets

• assets/frontmatter_template.md [blocked] — concept frontmatter template
• assets/index_template.md [blocked] / assets/log_template.md [blocked] — models for the reserved files
• assets/exemplo-bundle/ [blocked] — mini example bundle (00-fundacao + index.md + log.md)