tycono 0.3.42 → 0.3.43-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tycono",
-  "version": "0.3.42",
+  "version": "0.3.43-beta.0",
   "description": "Build an AI company. Watch them work.",
   "type": "module",
   "bin": {

package/src/api/src/create-server.ts

@@ -185,8 +185,8 @@ export function createExpressApp(): express.Application {
     let companyName: string | null = null;
     if (initialized) {
       try {
-        // Read company name from company/company.md (user-owned data)
-        const companyMdPath = path.join(COMPANY_ROOT, 'company', 'company.md');
+        // Read company name from knowledge/company.md (user-owned data)
+        const companyMdPath = path.join(COMPANY_ROOT, 'knowledge', 'company.md');
         const content = fs.readFileSync(companyMdPath, 'utf-8');
         const match = content.match(/^#\s+(.+)/m);
         if (match) companyName = match[1].trim();

package/src/api/src/engine/agent-loop.ts

@@ -655,10 +655,10 @@ export async function runAgentLoop(config: AgentConfig): Promise<AgentResult> {
         '',
         '## ④ Knowledge 업데이트 (The Loop Step 4)',
         '다음 중 해당하는 항목을 수행하세요:',
-        '- 본인 journal 업데이트 (`roles/' + roleId + '/journal/YYYY-MM-DD.md` — 오늘 날짜 파일)',
+        '- 본인 journal 업데이트 (`knowledge/roles/' + roleId + '/journal/YYYY-MM-DD.md` — 오늘 날짜 파일)',
         '- 구현 중 새로 발견한 패턴/아키텍처 결정이 있다면 관련 문서 업데이트',
-        '  (예: architecture/web-app-ia.md, architecture/session-worktree-isolation.md 등)',
-        '- 중요한 기술 결정은 operations/decisions/ 또는 architecture/ 반영',
+        '  (예: knowledge/architecture/web-app-ia.md, knowledge/architecture/session-worktree-isolation.md 등)',
+        '- 중요한 기술 결정은 knowledge/decisions/ 또는 knowledge/architecture/ 반영',
         '',
         '## ⑤ Task 상태 갱신 (The Loop Step 5)',
         '- `projects/tycono-platform/tasks.md` (또는 관련 tasks 파일)에서 완료한 태스크 상태를 DONE으로 변경',

package/src/api/src/engine/context-assembler.ts

@@ -275,7 +275,7 @@ ${docList}
  * Returns concatenated content (capped at 2000 chars per doc).
  */
 function loadPresetKnowledge(companyRoot: string, presetId: string): string | null {
-  const knowledgeDir = path.join(companyRoot, 'company', 'presets', presetId, 'knowledge');
+  const knowledgeDir = path.join(companyRoot, 'knowledge', 'presets', presetId, 'knowledge');
   if (!fs.existsSync(knowledgeDir)) return null;
 
   const parts: string[] = [];
@@ -309,8 +309,8 @@ function loadCompanyRules(companyRoot: string): string | null {
     }
   }
 
-  // 3. Company info (company/company.md — user owned)
-  const companyMdPath = path.join(companyRoot, 'company', 'company.md');
+  // 3. Company info (knowledge/company.md — user owned)
+  const companyMdPath = path.join(companyRoot, 'knowledge', 'company.md');
   if (fs.existsSync(companyMdPath)) {
     const companyInfo = fs.readFileSync(companyMdPath, 'utf-8').trim();
     if (companyInfo) {
@@ -450,7 +450,7 @@ function loadHubSummaries(companyRoot: string, node: OrgNode): string | null {
 }
 
 function loadCeoDecisions(companyRoot: string): string | null {
-  const decisionsDir = path.join(companyRoot, 'operations', 'decisions');
+  const decisionsDir = path.join(companyRoot, 'knowledge', 'decisions');
   if (!fs.existsSync(decisionsDir)) return null;
 
   const files = fs.readdirSync(decisionsDir)
@@ -834,7 +834,7 @@ function buildKnowledgeManagementSection(roleId: string): string {
   const domainScope = roleId === 'cto'
     ? '`architecture/`, `knowledge/` (technical docs)'
     : roleId === 'cbo'
-      ? '`knowledge/`, `company/` (business docs)'
+      ? '`knowledge/` (business docs)'
       : '`knowledge/` (your domain docs)';
 
   return `# Knowledge Consistency Management (C-Level Responsibility)

package/src/api/src/engine/knowledge-gate.ts

@@ -88,7 +88,7 @@ export function extractKeywords(text: string): string[] {
 export function searchRelatedDocs(companyRoot: string, keywords: string[]): RelatedDoc[] {
   if (keywords.length === 0) return [];
 
-  const searchDirs = ['knowledge', 'architecture', 'projects'];
+  const searchDirs = ['knowledge', 'knowledge/architecture', 'knowledge/projects'];
   const results: RelatedDoc[] = [];
 
   for (const dir of searchDirs) {
@@ -222,7 +222,7 @@ export function postKnowledgingCheck(
 
     // Categorize
     // We can't tell new vs modified from just file list, so check if it's a knowledge/architecture doc
-    if (file.startsWith('knowledge/') || file.startsWith('architecture/') || file.startsWith('projects/')) {
+    if (file.startsWith('knowledge/') || file.startsWith('knowledge/architecture/') || file.startsWith('knowledge/projects/')) {
       modifiedDocs.push(file);
     }
 
@@ -257,7 +257,7 @@ export function postKnowledgingCheck(
 
 /** Scan for orphan docs (not registered in Hub) and broken links */
 export function detectDecay(companyRoot: string): DecayReport {
-  const searchDirs = ['knowledge', 'architecture'];
+  const searchDirs = ['knowledge', 'knowledge/architecture'];
   const orphanDocs: string[] = [];
   const staleDocs: string[] = [];
   const brokenLinks: Array<{ file: string; link: string }> = [];

package/src/api/src/engine/org-tree.ts

@@ -86,7 +86,7 @@ interface RawRoleYaml {
 /* ─── Build ──────────────────────────────────── */
 
 export function buildOrgTree(companyRoot: string, presetId?: string): OrgTree {
-  const rolesDir = path.join(companyRoot, 'roles');
+  const rolesDir = path.join(companyRoot, 'knowledge', 'roles');
   const tree: OrgTree = { root: 'ceo', nodes: new Map() };
 
   // CEO is implicit (not a role.yaml file)
@@ -108,7 +108,7 @@ export function buildOrgTree(companyRoot: string, presetId?: string): OrgTree {
 
   // If preset specified, also scan preset's roles directory
   if (presetId && presetId !== 'default') {
-    const presetRolesDir = path.join(companyRoot, 'company', 'presets', presetId, 'roles');
+    const presetRolesDir = path.join(companyRoot, 'knowledge', 'presets', presetId, 'roles');
     if (fs.existsSync(presetRolesDir)) roleDirs.push(presetRolesDir);
   }
 

package/src/api/src/engine/role-lifecycle.ts

@@ -57,7 +57,7 @@ export class RoleLifecycleManager {
    * Create a new Role: role.yaml + SKILL.md + profile.md + journal/
    */
   async createRole(def: RoleDefinition): Promise<void> {
-    const roleDir = path.join(this.companyRoot, 'roles', def.id);
+    const roleDir = path.join(this.companyRoot, 'knowledge', 'roles', def.id);
     const skillDir = path.join(this.companyRoot, '.claude', 'skills', def.id);
     const journalDir = path.join(roleDir, 'journal');
 
@@ -105,7 +105,7 @@ export class RoleLifecycleManager {
    * Update an existing Role's definition
    */
   async updateRole(id: string, changes: Partial<RoleDefinition>): Promise<void> {
-    const yamlPath = path.join(this.companyRoot, 'roles', id, 'role.yaml');
+    const yamlPath = path.join(this.companyRoot, 'knowledge', 'roles', id, 'role.yaml');
     if (!fs.existsSync(yamlPath)) {
       throw new Error(`Role not found: ${id}`);
     }
@@ -145,7 +145,7 @@ export class RoleLifecycleManager {
    * Remove a Role and all its files
    */
   async removeRole(id: string): Promise<void> {
-    const roleDir = path.join(this.companyRoot, 'roles', id);
+    const roleDir = path.join(this.companyRoot, 'knowledge', 'roles', id);
     const skillDir = path.join(this.companyRoot, '.claude', 'skills', id);
 
     if (fs.existsSync(roleDir)) {
@@ -180,7 +180,7 @@ export class RoleLifecycleManager {
   validateRole(id: string): RoleValidationResult {
     const issues: RoleValidationResult['issues'] = [];
 
-    const roleDir = path.join(this.companyRoot, 'roles', id);
+    const roleDir = path.join(this.companyRoot, 'knowledge', 'roles', id);
     const yamlPath = path.join(roleDir, 'role.yaml');
     const profilePath = path.join(roleDir, 'profile.md');
     const journalDir = path.join(roleDir, 'journal');
@@ -223,7 +223,7 @@ export class RoleLifecycleManager {
    */
   validateAll(): Map<string, RoleValidationResult> {
     const results = new Map<string, RoleValidationResult>();
-    const rolesDir = path.join(this.companyRoot, 'roles');
+    const rolesDir = path.join(this.companyRoot, 'knowledge', 'roles');
 
     if (!fs.existsSync(rolesDir)) return results;
 
@@ -319,7 +319,7 @@ ${def.authority.needsApproval.map((a) => `- ${a}`).join('\n')}
   }
 
   private addToRolesHub(def: RoleDefinition): void {
-    const hubPath = path.join(this.companyRoot, 'roles', 'roles.md');
+    const hubPath = path.join(this.companyRoot, 'knowledge', 'roles', 'roles.md');
     if (!fs.existsSync(hubPath)) return;
 
     const content = fs.readFileSync(hubPath, 'utf-8');
@@ -333,7 +333,7 @@ ${def.authority.needsApproval.map((a) => `- ${a}`).join('\n')}
   }
 
   private removeFromRolesHub(id: string): void {
-    const hubPath = path.join(this.companyRoot, 'roles', 'roles.md');
+    const hubPath = path.join(this.companyRoot, 'knowledge', 'roles', 'roles.md');
     if (!fs.existsSync(hubPath)) return;
 
     const content = fs.readFileSync(hubPath, 'utf-8');

package/src/api/src/engine/tools/definitions.ts

@@ -10,7 +10,7 @@ export const READ_TOOLS: ToolDefinition[] = [
     input_schema: {
       type: 'object',
       properties: {
-        path: { type: 'string', description: 'File path relative to company root (e.g., "roles/cto/role.yaml")' },
+        path: { type: 'string', description: 'File path relative to company root (e.g., "knowledge/roles/cto/role.yaml")' },
       },
       required: ['path'],
     },

package/src/api/src/routes/company.ts

@@ -8,7 +8,7 @@ export const companyRouter = Router();
 // GET /api/company — 회사 기본 정보
 companyRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const companyContent = readFile('company/company.md');
+    const companyContent = readFile('knowledge/company.md');
     const kv = extractBoldKeyValues(companyContent);
 
     // blockquote에서 미션 추출
@@ -16,7 +16,7 @@ companyRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
     const mission = missionMatch ? missionMatch[1].trim() : '';
 
     // Role 목록
-    const rolesContent = readFile('roles/roles.md');
+    const rolesContent = readFile('knowledge/roles/roles.md');
     const roleRows = parseMarkdownTable(rolesContent);
     const roles = roleRows
       .filter(row => (row.id ?? '').toLowerCase() !== 'ceo')
@@ -25,7 +25,7 @@ companyRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
         let name = row.role ?? row.name ?? '';
 
         // role.yaml의 name이 있으면 우선 사용 (커스텀 이름 반영)
-        const yamlPath = `roles/${id}/role.yaml`;
+        const yamlPath = `knowledge/roles/${id}/role.yaml`;
         if (id && fileExists(yamlPath)) {
           try {
             const raw = YAML.parse(readFile(yamlPath)) as Record<string, unknown>;

package/src/api/src/routes/execute.ts

@@ -325,7 +325,7 @@ function handleSaveWave(body: Record<string, unknown>, res: ServerResponse): voi
     );
 
     // Scan activity-streams for sessions belonging to this wave
-    const streamsDir = path.join(COMPANY_ROOT, 'operations', 'activity-streams');
+    const streamsDir = path.join(COMPANY_ROOT, '.tycono', 'activity-streams');
     if (fs.existsSync(streamsDir)) {
       const waveTimestamp = waveId.replace('wave-', '');
       for (const file of fs.readdirSync(streamsDir)) {
@@ -407,7 +407,7 @@ function handleSaveWave(body: Record<string, unknown>, res: ServerResponse): voi
     rolesData.push({ roleId, roleName, sessionId: sid, status, events, childSessions });
   }
 
-  const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+  const wavesDir = path.join(COMPANY_ROOT, '.tycono', 'waves');
   if (!fs.existsSync(wavesDir)) {
     fs.mkdirSync(wavesDir, { recursive: true });
   }
@@ -477,7 +477,7 @@ function handleSaveWave(body: Record<string, unknown>, res: ServerResponse): voi
     } catch { /* non-critical */ }
   }
 
-  jsonResponse(res, 200, { ok: true, path: `operations/waves/${baseName}.json` });
+  jsonResponse(res, 200, { ok: true, path: `.tycono/waves/${baseName}.json` });
 }
 
 /* ─── GET /api/waves/:waveId/stream ── */

package/src/api/src/routes/operations.ts

@@ -11,12 +11,12 @@ export const operationsRouter = Router();
 // --- Standups ---
 operationsRouter.get('/standups', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const files = listFiles('operations/standup');
+    const files = listFiles('.tycono/standup');
     const standups = files
       .filter(f => f.endsWith('.md'))
       .map(f => {
         const date = path.basename(f, '.md');
-        const content = readFile(`operations/standup/${f}`);
+        const content = readFile(`.tycono/standup/${f}`);
         return { date, content };
       })
       .sort((a, b) => b.date.localeCompare(a.date));
@@ -30,7 +30,7 @@ operationsRouter.get('/standups', (_req: Request, res: Response, next: NextFunct
 operationsRouter.get('/standups/:date', (req: Request, res: Response, next: NextFunction) => {
   try {
     const { date } = req.params;
-    const filePath = `operations/standup/${date}.md`;
+    const filePath = `.tycono/standup/${date}.md`;
     if (!fileExists(filePath)) {
       res.status(404).json({ error: `Standup not found: ${date}` });
       return;
@@ -45,12 +45,12 @@ operationsRouter.get('/standups/:date', (req: Request, res: Response, next: Next
 // --- Waves (JSON-only) ---
 operationsRouter.get('/waves', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const files = listFiles('operations/waves', '*.json');
+    const files = listFiles('.tycono/waves', '*.json');
     const waves = files
       .map(f => {
         const id = path.basename(f, '.json');
         try {
-          const data = JSON.parse(readFile(`operations/waves/${f}`));
+          const data = JSON.parse(readFile(`.tycono/waves/${f}`));
           const roles = data.roles ?? [];
           const hasRunning = roles.some((r: { status?: string }) => r.status && isMessageActive(r.status as MessageStatus));
           return {
@@ -78,7 +78,7 @@ operationsRouter.get('/waves', (_req: Request, res: Response, next: NextFunction
 operationsRouter.get('/waves/:id', (req: Request, res: Response, next: NextFunction) => {
   try {
     const { id } = req.params;
-    const jsonPath = `operations/waves/${id}.json`;
+    const jsonPath = `.tycono/waves/${id}.json`;
 
     if (!fileExists(jsonPath)) {
       res.status(404).json({ error: `Wave not found: ${id}` });
@@ -96,7 +96,7 @@ operationsRouter.get('/waves/:id', (req: Request, res: Response, next: NextFunct
 operationsRouter.patch('/waves/:id', (req: Request, res: Response, next: NextFunction) => {
   try {
     const { id } = req.params;
-    const jsonPath = `operations/waves/${id}.json`;
+    const jsonPath = `.tycono/waves/${id}.json`;
 
     if (!fileExists(jsonPath)) {
       res.status(404).json({ error: `Wave not found: ${id}` });
@@ -119,12 +119,12 @@ operationsRouter.patch('/waves/:id', (req: Request, res: Response, next: NextFun
 // --- Decisions ---
 operationsRouter.get('/decisions', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const files = listFiles('operations/decisions');
+    const files = listFiles('knowledge/decisions');
     const decisions = files
       .filter(f => f.endsWith('.md'))
       .map(f => {
         const id = path.basename(f, '.md');
-        const content = readFile(`operations/decisions/${f}`);
+        const content = readFile(`knowledge/decisions/${f}`);
         const firstLine = content.split('\n').find(l => l.startsWith('# '));
         const title = firstLine ? firstLine.replace(/^#\s+/, '') : id;
         const kv = extractBoldKeyValues(content);
@@ -146,7 +146,7 @@ operationsRouter.put('/decisions/:id', (req: Request, res: Response, next: NextF
       res.status(400).json({ error: 'content (string) is required' });
       return;
     }
-    const filePath = `operations/decisions/${id}.md`;
+    const filePath = `knowledge/decisions/${id}.md`;
     const absPath = path.resolve(COMPANY_ROOT, filePath);
     // Ensure parent directory exists
     fs.mkdirSync(path.dirname(absPath), { recursive: true });
@@ -165,7 +165,7 @@ operationsRouter.put('/decisions/:id', (req: Request, res: Response, next: NextF
 operationsRouter.delete('/decisions/:id', (req: Request, res: Response, next: NextFunction) => {
   try {
     const { id } = req.params;
-    const filePath = `operations/decisions/${id}.md`;
+    const filePath = `knowledge/decisions/${id}.md`;
     const absPath = path.resolve(COMPANY_ROOT, filePath);
     if (!fs.existsSync(absPath)) {
       res.status(404).json({ error: `Decision not found: ${id}` });

package/src/api/src/routes/presets.ts

@@ -62,7 +62,7 @@ presetsRouter.post('/install', (req, res) => {
     }
 
     // Create preset directory and write preset.yaml
-    const presetDir = path.join(COMPANY_ROOT, 'company', 'presets', id);
+    const presetDir = path.join(COMPANY_ROOT, 'knowledge', 'presets', id);
     fs.mkdirSync(presetDir, { recursive: true });
 
     // Write preset.yaml
@@ -92,7 +92,7 @@ presetsRouter.post('/install', (req, res) => {
       }
     }
 
-    res.json({ ok: true, id, path: `company/presets/${id}` });
+    res.json({ ok: true, id, path: `knowledge/presets/${id}` });
   } catch (err) {
     res.status(500).json({ error: `Install failed: ${err instanceof Error ? err.message : 'unknown'}` });
   }
@@ -107,7 +107,7 @@ presetsRouter.delete('/:id', (req, res) => {
       return;
     }
 
-    const presetDir = path.join(COMPANY_ROOT, 'company', 'presets', id);
+    const presetDir = path.join(COMPANY_ROOT, 'knowledge', 'presets', id);
     if (!fs.existsSync(presetDir)) {
       res.status(404).json({ error: `Preset not found: ${id}` });
       return;

package/src/api/src/routes/projects.ts

@@ -7,7 +7,7 @@ export const projectsRouter = Router();
 // GET /api/projects — 프로젝트 목록
 projectsRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const content = readFile('projects/projects.md');
+    const content = readFile('knowledge/projects/projects.md');
     const rows = parseMarkdownTable(content);
 
     const projects = rows.map(row => {
@@ -33,7 +33,7 @@ projectsRouter.get('/:id', (req: Request, res: Response, next: NextFunction) =>
     const { id } = req.params;
 
     // 기본 정보
-    const listContent = readFile('projects/projects.md');
+    const listContent = readFile('knowledge/projects/projects.md');
     const rows = parseMarkdownTable(listContent);
     const projectRow = rows.find(r => {
       const name = r.project ?? '';
@@ -56,13 +56,13 @@ projectsRouter.get('/:id', (req: Request, res: Response, next: NextFunction) =>
     };
 
     // PRD 읽기
-    const prdPath = `projects/${id}/prd.md`;
+    const prdPath = `knowledge/projects/${id}/prd.md`;
     if (fileExists(prdPath)) {
       project.prd = readFile(prdPath);
     }
 
     // Tasks 읽기
-    const tasksPath = `projects/${id}/tasks.md`;
+    const tasksPath = `knowledge/projects/${id}/tasks.md`;
     if (fileExists(tasksPath)) {
       const tasksContent = readFile(tasksPath);
       const taskRows = parseMarkdownTable(tasksContent);

package/src/api/src/routes/roles.ts

@@ -8,7 +8,7 @@ export const rolesRouter = Router();
 // GET /api/roles — Role 목록
 rolesRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
   try {
-    const content = readFile('roles/roles.md');
+    const content = readFile('knowledge/roles/roles.md');
     const rows = parseMarkdownTable(content);
 
     const roles = rows.map(row => {
@@ -16,7 +16,7 @@ rolesRouter.get('/', (_req: Request, res: Response, next: NextFunction) => {
       let name = row.role ?? row.name ?? '';
 
       // role.yaml의 name이 있으면 우선 사용 (rename 반영)
-      const yamlPath = `roles/${id}/role.yaml`;
+      const yamlPath = `knowledge/roles/${id}/role.yaml`;
       if (id && fileExists(yamlPath)) {
         try {
           const raw = YAML.parse(readFile(yamlPath)) as Record<string, unknown>;
@@ -45,7 +45,7 @@ rolesRouter.get('/:id', (req: Request, res: Response, next: NextFunction) => {
     const { id } = req.params;
 
     // 기본 정보 (roles.md 테이블에서)
-    const listContent = readFile('roles/roles.md');
+    const listContent = readFile('knowledge/roles/roles.md');
     const rows = parseMarkdownTable(listContent);
     const roleRow = rows.find(r => r.id === id);
 
@@ -66,7 +66,7 @@ rolesRouter.get('/:id', (req: Request, res: Response, next: NextFunction) => {
     };
 
     // role.yaml에서 name + persona + authority + skills 읽기
-    const yamlPath = `roles/${id}/role.yaml`;
+    const yamlPath = `knowledge/roles/${id}/role.yaml`;
     if (fileExists(yamlPath)) {
       const raw = YAML.parse(readFile(yamlPath)) as Record<string, unknown>;
       if (raw.name) role.name = raw.name;
@@ -100,7 +100,7 @@ rolesRouter.get('/:id', (req: Request, res: Response, next: NextFunction) => {
 
     // 오늘 저널 읽기
     const today = new Date().toISOString().slice(0, 10);
-    const journalPath = `roles/${id}/journal/${today}.md`;
+    const journalPath = `knowledge/roles/${id}/journal/${today}.md`;
     if (fileExists(journalPath)) {
       role.journal = readFile(journalPath).slice(0, 3000);
     }

package/src/api/src/routes/skills.ts

@@ -226,7 +226,7 @@ skillsRouter.post('/role/:roleId', (req: Request, res: Response, next: NextFunct
     }
 
     // Add to role.yaml skills array
-    const yamlPath = path.join(COMPANY_ROOT, 'roles', roleId, 'role.yaml');
+    const yamlPath = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'role.yaml');
     if (!fs.existsSync(yamlPath)) {
       res.status(404).json({ error: `Role not found: ${roleId}` });
       return;
@@ -256,7 +256,7 @@ skillsRouter.delete('/role/:roleId/:skillId', (req: Request, res: Response, next
     const roleId = req.params.roleId as string;
     const skillId = req.params.skillId as string;
 
-    const yamlPath = path.join(COMPANY_ROOT, 'roles', roleId, 'role.yaml');
+    const yamlPath = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'role.yaml');
     if (!fs.existsSync(yamlPath)) {
       res.status(404).json({ error: `Role not found: ${roleId}` });
       return;
@@ -307,7 +307,7 @@ function installSkillFromTemplate(skillId: string): void {
 }
 
 function getRoleSkills(roleId: string): string[] {
-  const yamlPath = path.join(COMPANY_ROOT, 'roles', roleId, 'role.yaml');
+  const yamlPath = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'role.yaml');
   if (!fs.existsSync(yamlPath)) return [];
 
   const raw = YAML.parse(fs.readFileSync(yamlPath, 'utf-8')) as Record<string, unknown>;

package/src/api/src/routes/speech.ts

@@ -100,7 +100,7 @@ const AKB_TOOLS: ToolDefinition[] = [
       type: 'object' as const,
       properties: {
         query: { type: 'string', description: 'Search keywords (e.g. "landing deploy", "refactoring decision", "Store Import")' },
-        path: { type: 'string', description: 'Optional subdirectory to search in (e.g. "operations/decisions", "projects", "knowledge"). Defaults to entire AKB.' },
+        path: { type: 'string', description: 'Optional subdirectory to search in (e.g. "knowledge/decisions", "knowledge/projects", "knowledge"). Defaults to entire AKB.' },
       },
       required: ['query'],
     },
@@ -111,18 +111,18 @@ const AKB_TOOLS: ToolDefinition[] = [
     input_schema: {
       type: 'object' as const,
       properties: {
-        path: { type: 'string', description: 'File path relative to AKB root (e.g. "operations/decisions/008-repo-structure.md", "projects/projects.md")' },
+        path: { type: 'string', description: 'File path relative to AKB root (e.g. "knowledge/decisions/008-repo-structure.md", "knowledge/projects/projects.md")' },
       },
       required: ['path'],
     },
   },
   {
     name: 'list_files',
-    description: 'List files in a directory. Useful to discover what exists (e.g. "operations/waves/", "roles/engineer/journal/").',
+    description: 'List files in a directory. Useful to discover what exists (e.g. ".tycono/waves/", "knowledge/roles/engineer/journal/").',
     input_schema: {
       type: 'object' as const,
       properties: {
-        path: { type: 'string', description: 'Directory path relative to AKB root (e.g. "operations/standups", "roles/pm/journal")' },
+        path: { type: 'string', description: 'Directory path relative to AKB root (e.g. ".tycono/standup", "knowledge/roles/pm/journal")' },
         pattern: { type: 'string', description: 'Glob pattern (default: "*.md")' },
       },
       required: ['path'],
@@ -257,7 +257,7 @@ function buildCompanyContext(): string {
 
   // 1. Company info (name, mission)
   try {
-    const companyContent = readFile('company/company.md');
+    const companyContent = readFile('knowledge/company.md');
     const companyName = companyContent.split('\n').find(l => l.startsWith('# '))?.replace(/^#\s+/, '') ?? '';
     const missionMatch = companyContent.match(/^>\s*(.+)/m);
     const mission = missionMatch ? missionMatch[1].trim() : '';
@@ -283,7 +283,7 @@ function buildCompanyContext(): string {
 
   // 3. Active projects + current phase from tasks.md
   try {
-    const projectsContent = readFile('projects/projects.md');
+    const projectsContent = readFile('knowledge/projects/projects.md');
     const rows = parseMarkdownTable(projectsContent);
     const activeProjects = rows
       .filter(r => (r.status ?? r.상태 ?? '').toLowerCase() !== 'archived')
@@ -335,7 +335,7 @@ function buildCompanyContext(): string {
 
   // 5. Recent CEO decisions (max 5)
   try {
-    const decisionsDir = path.join(COMPANY_ROOT, 'operations', 'decisions');
+    const decisionsDir = path.join(COMPANY_ROOT, 'knowledge', 'decisions');
     if (fs.existsSync(decisionsDir)) {
       const files = fs.readdirSync(decisionsDir)
         .filter(f => f.endsWith('.md') && f !== 'decisions.md')
@@ -370,7 +370,7 @@ function buildRoleContext(roleId: string): string {
 
   // 0. Role profile — gives the agent its identity and work context
   try {
-    const profilePath = path.join(COMPANY_ROOT, 'roles', roleId, 'profile.md');
+    const profilePath = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'profile.md');
     if (fs.existsSync(profilePath)) {
       const content = fs.readFileSync(profilePath, 'utf-8').trim();
       if (content.length > 20) {
@@ -381,7 +381,7 @@ function buildRoleContext(roleId: string): string {
 
   // 1. Role's journal — latest entry only, compact summary (not full header dump)
   try {
-    const journalDir = path.join(COMPANY_ROOT, 'roles', roleId, 'journal');
+    const journalDir = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'journal');
     if (fs.existsSync(journalDir)) {
       const files = fs.readdirSync(journalDir)
         .filter(f => f.endsWith('.md'))
@@ -399,7 +399,7 @@ function buildRoleContext(roleId: string): string {
 
   // 2. Current tasks assigned to this role (from all project tasks.md files)
   try {
-    const projectsDir = path.join(COMPANY_ROOT, 'projects');
+    const projectsDir = path.join(COMPANY_ROOT, 'knowledge', 'projects');
     if (fs.existsSync(projectsDir)) {
       const taskFiles = glob.sync('**/tasks.md', { cwd: projectsDir, absolute: false });
       const roleTasks: string[] = [];
@@ -425,7 +425,7 @@ function buildRoleContext(roleId: string): string {
 
   // 3. Recent waves — only from last 7 days (stale waves cause repetitive references)
   try {
-    const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+    const wavesDir = path.join(COMPANY_ROOT, '.tycono', 'waves');
     if (fs.existsSync(wavesDir)) {
       const tree = buildOrgTree(COMPANY_ROOT);
       const node = tree.nodes.get(roleId);
@@ -473,7 +473,7 @@ function buildRoleContext(roleId: string): string {
 
   // 4. Recent standup (latest, this role's section)
   try {
-    const standupDir = path.join(COMPANY_ROOT, 'operations', 'standup');
+    const standupDir = path.join(COMPANY_ROOT, '.tycono', 'standup');
     if (fs.existsSync(standupDir)) {
       const files = fs.readdirSync(standupDir).filter(f => f.endsWith('.md')).sort().slice(-1);
       for (const file of files) {
@@ -489,7 +489,7 @@ function buildRoleContext(roleId: string): string {
 
   // 5. Recent decisions (last 3)
   try {
-    const decisionsDir = path.join(COMPANY_ROOT, 'operations', 'decisions');
+    const decisionsDir = path.join(COMPANY_ROOT, 'knowledge', 'decisions');
     if (fs.existsSync(decisionsDir)) {
       const files = fs.readdirSync(decisionsDir)
         .filter(f => f.endsWith('.md') && f !== 'decisions.md')
@@ -863,7 +863,7 @@ ${companyCtx}
 ${roleCtx}
 
 You have search_akb, read_file, list_files tools. AKB root: ${COMPANY_ROOT}/
-Optionally explore 1-2 for fresh context: operations/waves/, operations/decisions/, roles/${roleId}/journal/
+Optionally explore 1-2 for fresh context: .tycono/waves/, knowledge/decisions/, knowledge/roles/${roleId}/journal/
 
 RULES:
 1. Match the tone and length from the example conversations above. 1-3 sentences MAX.

package/src/api/src/routes/sync.ts

@@ -65,7 +65,7 @@ syncRouter.post('/apply', async (req: Request, res: Response, next: NextFunction
 
     // Update source.upstream_version if provided
     if (upstreamVersion) {
-      const yamlPath = path.join(COMPANY_ROOT, 'roles', roleId, 'role.yaml');
+      const yamlPath = path.join(COMPANY_ROOT, 'knowledge', 'roles', roleId, 'role.yaml');
       const raw = YAML.parse(fs.readFileSync(yamlPath, 'utf-8')) as Record<string, unknown>;
       if (raw.source && typeof raw.source === 'object') {
         (raw.source as Record<string, unknown>).upstream_version = upstreamVersion;

package/src/api/src/services/activity-stream.ts

@@ -10,7 +10,7 @@ import type { ActivityEventType, ActivityEvent } from '../../../shared/types.js'
 /* ─── Constants ──────────────────────────── */
 
 function streamsDir(): string {
-  return path.join(COMPANY_ROOT, 'operations', 'activity-streams');
+  return path.join(COMPANY_ROOT, '.tycono', 'activity-streams');
 }
 
 function ensureDir(): void {

package/src/api/src/services/activity-tracker.ts

@@ -4,7 +4,7 @@ import { COMPANY_ROOT } from './file-reader.js';
 import type { RoleStatus } from '../../../shared/types.js';
 
 function activityDir(): string {
-  return path.join(COMPANY_ROOT, 'operations', 'activity');
+  return path.join(COMPANY_ROOT, '.tycono', 'activity');
 }
 
 export interface RoleActivity {

package/src/api/src/services/execution-manager.ts

@@ -124,7 +124,7 @@ class ExecutionManager {
     const session = getSession(params.sessionId);
     if (session?.waveId) {
       try {
-        const wavePath = path.join(COMPANY_ROOT, 'operations', 'waves', `${session.waveId}.json`);
+        const wavePath = path.join(COMPANY_ROOT, '.tycono', 'waves', `${session.waveId}.json`);
         if (fs.existsSync(wavePath)) {
           const waveData = JSON.parse(fs.readFileSync(wavePath, 'utf-8'));
           presetId = waveData.preset;
@@ -698,7 +698,7 @@ class ExecutionManager {
     const deadSession = getSession(deadExecution.sessionId);
     if (deadSession?.waveId) {
       try {
-        const wp = path.join(COMPANY_ROOT, 'operations', 'waves', `${deadSession.waveId}.json`);
+        const wp = path.join(COMPANY_ROOT, '.tycono', 'waves', `${deadSession.waveId}.json`);
         if (fs.existsSync(wp)) {
           recoveryPresetId = JSON.parse(fs.readFileSync(wp, 'utf-8')).preset;
         }

package/src/api/src/services/git-save.ts

@@ -73,16 +73,7 @@ export interface SyncStatus {
  * See: knowledge/data-persistence-architecture.md §2
  */
 const SAVE_PATHS = [
-  'roles/',
-  'projects/',
   'knowledge/',
-  'architecture/',
-  'company/',
-  'operations/standup/',
-  'operations/waves/',
-  'operations/decisions/',
-  'operations/cost/',
-  'operations/activity-streams/',
   '.claude/skills/',
   '.tycono/',
   'CLAUDE.md',

package/src/api/src/services/preset-loader.ts

@@ -1,8 +1,8 @@
 /**
- * preset-loader.ts — Load presets from company/presets/
+ * preset-loader.ts — Load presets from knowledge/presets/
  *
- * Scans company/presets/ for:
- *   - _default.yaml (auto-generated from existing roles/)
+ * Scans knowledge/presets/ for:
+ *   - _default.yaml (auto-generated from existing knowledge/roles/)
  *   - {name}/preset.yaml (installed presets with roles/skills/knowledge)
  *
  * Returns PresetSummary[] for TUI display and full LoadedPreset for wave creation.
@@ -12,7 +12,7 @@ import path from 'node:path';
 import YAML from 'yaml';
 import type { PresetDefinition, LoadedPreset, PresetSummary } from '../../../shared/types.js';
 
-const PRESETS_DIR = 'company/presets';
+const PRESETS_DIR = 'knowledge/presets';
 const DEFAULT_PRESET_FILE = '_default.yaml';
 
 /**
@@ -20,7 +20,7 @@ const DEFAULT_PRESET_FILE = '_default.yaml';
  * This is generated on-the-fly — no need to persist _default.yaml.
  */
 function buildDefaultPreset(companyRoot: string): LoadedPreset {
-  const rolesDir = path.join(companyRoot, 'roles');
+  const rolesDir = path.join(companyRoot, 'knowledge', 'roles');
   const roles: string[] = [];
 
   if (fs.existsSync(rolesDir)) {

package/src/api/src/services/scaffold.ts

@@ -314,12 +314,12 @@ export function scaffold(config: ScaffoldConfig): string[] {
 
   // Create directories
   const dirs = [
-    'company', 'roles', 'projects', 'architecture',
-    'operations', 'operations/standup', 'operations/waves',
-    'operations/decisions', 'operations/activity-streams',
-    'operations/sessions', 'operations/cost',
-    'knowledge', 'methodologies', '.claude/skills',
-    '.claude/skills/_shared', '.tycono', 'company/presets',
+    'knowledge', 'knowledge/roles', 'knowledge/projects',
+    'knowledge/architecture', 'knowledge/methodologies',
+    'knowledge/decisions', 'knowledge/presets',
+    '.tycono/waves', '.tycono/sessions', '.tycono/standup',
+    '.tycono/activity-streams', '.tycono/cost', '.tycono/activity',
+    '.claude/skills', '.claude/skills/_shared', '.tycono',
   ];
   for (const dir of dirs) {
     fs.mkdirSync(path.join(root, dir), { recursive: true });
@@ -343,15 +343,15 @@ export function scaffold(config: ScaffoldConfig): string[] {
     created.push('.tycono/custom-rules.md');
   }
 
-  // Write company/company.md
+  // Write knowledge/company.md
   const companyTmpl = loadTemplate('company.md.tmpl');
-  fs.writeFileSync(path.join(root, 'company', 'company.md'), renderTemplate(companyTmpl, vars));
-  created.push('company/company.md');
+  fs.writeFileSync(path.join(root, 'knowledge', 'company.md'), renderTemplate(companyTmpl, vars));
+  created.push('knowledge/company.md');
 
-  // Write roles/roles.md
+  // Write knowledge/roles/roles.md
   const rolesTmpl = loadTemplate('roles.md.tmpl');
-  fs.writeFileSync(path.join(root, 'roles', 'roles.md'), renderTemplate(rolesTmpl, vars));
-  created.push('roles/roles.md');
+  fs.writeFileSync(path.join(root, 'knowledge', 'roles', 'roles.md'), renderTemplate(rolesTmpl, vars));
+  created.push('knowledge/roles/roles.md');
 
   // Write .gitignore
   const giTmpl = loadTemplate('gitignore.tmpl');
@@ -400,14 +400,14 @@ export function scaffold(config: ScaffoldConfig): string[] {
     // Create roles with skill references
     for (const role of roles) {
       createRole(root, role);
-      created.push(`roles/${role.id}/`);
+      created.push(`knowledge/roles/${role.id}/`);
     }
   }
 
   // Hub files
   const hubs: Record<string, string> = {
-    'projects/projects.md': `# Projects\n\nProject listing for ${config.companyName}.\n\n| Project | Status | Lead |\n|---------|--------|------|\n`,
-    'architecture/architecture.md': `# Architecture\n\nTechnical architecture for ${config.companyName}.\n`,
+    'knowledge/projects/projects.md': `# Projects\n\nProject listing for ${config.companyName}.\n\n| Project | Status | Lead |\n|---------|--------|------|\n`,
+    'knowledge/architecture/architecture.md': `# Architecture\n\nTechnical architecture for ${config.companyName}.\n`,
     'knowledge/knowledge.md': `# Knowledge Base\n\nDomain knowledge for ${config.companyName}.\n`,
   };
   for (const [filePath, content] of Object.entries(hubs)) {
@@ -419,15 +419,15 @@ export function scaffold(config: ScaffoldConfig): string[] {
   }
 
   // Methodology documents
-  const methodologiesHub = path.join(root, 'methodologies', 'methodologies.md');
+  const methodologiesHub = path.join(root, 'knowledge', 'methodologies', 'methodologies.md');
   if (!fs.existsSync(methodologiesHub)) {
     fs.writeFileSync(methodologiesHub, `# Methodologies\n\n> Frameworks and principles that guide how AI agents work in this organization.\n\n## Documents\n\n| Document | Description |\n|----------|-------------|\n| [agentic-knowledge-base.md](./agentic-knowledge-base.md) | AKB — the file-based knowledge protocol for AI agents |\n\n---\n\n*Managed by: All*\n`);
-    created.push('methodologies/methodologies.md');
+    created.push('knowledge/methodologies/methodologies.md');
   }
-  const akbDoc = path.join(root, 'methodologies', 'agentic-knowledge-base.md');
+  const akbDoc = path.join(root, 'knowledge', 'methodologies', 'agentic-knowledge-base.md');
   if (!fs.existsSync(akbDoc)) {
     fs.writeFileSync(akbDoc, AKB_METHODOLOGY_CONTENT);
-    created.push('methodologies/agentic-knowledge-base.md');
+    created.push('knowledge/methodologies/agentic-knowledge-base.md');
   }
 
   // Set default appearances for team roles
@@ -445,14 +445,14 @@ export function scaffold(config: ScaffoldConfig): string[] {
 
   // Brownfield: note existing project path
   if (config.existingProjectPath) {
-    const targetDir = path.join(root, 'projects', 'existing');
+    const targetDir = path.join(root, 'knowledge', 'projects', 'existing');
     if (!fs.existsSync(targetDir)) {
       fs.mkdirSync(targetDir, { recursive: true });
       fs.writeFileSync(
         path.join(targetDir, 'prd.md'),
         `# Existing Project\n\nImported from: ${config.existingProjectPath}\n`
       );
-      created.push('projects/existing/');
+      created.push('knowledge/projects/existing/');
     }
   }
 
@@ -481,7 +481,7 @@ export function scaffold(config: ScaffoldConfig): string[] {
 }
 
 function createRole(root: string, role: TeamRole): void {
-  const roleDir = path.join(root, 'roles', role.id);
+  const roleDir = path.join(root, 'knowledge', 'roles', role.id);
   const skillDir = path.join(root, '.claude', 'skills', role.id);
   const journalDir = path.join(roleDir, 'journal');
 
@@ -533,7 +533,7 @@ function createRole(root: string, role: TeamRole): void {
   fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skill);
 
   // Append to roles.md
-  const rolesHubPath = path.join(root, 'roles', 'roles.md');
+  const rolesHubPath = path.join(root, 'knowledge', 'roles', 'roles.md');
   if (fs.existsSync(rolesHubPath)) {
     const hubContent = fs.readFileSync(rolesHubPath, 'utf-8');
     const row = `| ${role.name} | ${role.id} | ${role.level} | ${role.reportsTo} | Active |`;

package/src/api/src/services/session-store.ts

@@ -65,7 +65,7 @@ export interface Session {
 /* ─── Session directory ─────────────────── */
 
 function sessionsDir(): string {
-  return path.join(COMPANY_ROOT, 'operations', 'sessions');
+  return path.join(COMPANY_ROOT, '.tycono', 'sessions');
 }
 
 function ensureDir(): void {

package/src/api/src/services/supervisor-heartbeat.ts

@@ -123,7 +123,7 @@ class SupervisorHeartbeat {
    */
   private saveWaveFile(waveId: string, directive: string, preset?: string): void {
     try {
-      const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+      const wavesDir = path.join(COMPANY_ROOT, '.tycono', 'waves');
       if (!fs.existsSync(wavesDir)) fs.mkdirSync(wavesDir, { recursive: true });
       const wavePath = path.join(wavesDir, `${waveId}.json`);
       if (!fs.existsSync(wavePath)) {
@@ -185,7 +185,7 @@ class SupervisorHeartbeat {
       let originalDirective = '';
       let originalPreset: string | undefined;
       try {
-        const waveFile = path.join(COMPANY_ROOT, 'operations', 'waves', `${waveId}.json`);
+        const waveFile = path.join(COMPANY_ROOT, '.tycono', 'waves', `${waveId}.json`);
         if (fs.existsSync(waveFile)) {
           const waveData = JSON.parse(fs.readFileSync(waveFile, 'utf-8'));
           originalDirective = waveData.directive ?? '';
@@ -820,7 +820,7 @@ ${state.continuous ? `## Continuous Improvement Mode (ON)
         }
       }
 
-      // Auto-save the completed wave to operations/waves/
+      // Auto-save the completed wave to .tycono/waves/
       try {
         const result = saveCompletedWave(state.waveId, state.directive);
         if (result.ok) {

package/src/api/src/services/token-ledger.ts

@@ -37,7 +37,7 @@ export class TokenLedger {
   private filePath: string;
 
   constructor(companyRoot: string) {
-    const dir = path.join(companyRoot, 'operations', 'cost');
+    const dir = path.join(companyRoot, '.tycono', 'cost');
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
     }

package/src/api/src/services/wave-tracker.ts

@@ -13,7 +13,7 @@ import { type WaveRoleStatus, eventTypeToMessageStatus } from '../../../shared/t
 /* ─── Find wave file ──────────────────────── */
 
 export function findWaveFile(waveId: string): string | null {
-  const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+  const wavesDir = path.join(COMPANY_ROOT, '.tycono', 'waves');
   if (!fs.existsSync(wavesDir)) return null;
 
   const direct = path.join(wavesDir, `${waveId}.json`);
@@ -159,7 +159,7 @@ export function updateFollowUpInWave(waveId: string, sessionId: string, roleId:
   }
 }
 
-/* ─── Save completed wave to operations/waves/ ── */
+/* ─── Save completed wave to .tycono/waves/ ── */
 
 /**
  * Auto-save a completed wave to disk.
@@ -178,7 +178,7 @@ export function saveCompletedWave(waveId: string, directive: string): { ok: bool
     // Scan activity-streams for ALL sessions belonging to this wave.
     // Wave sessions share a traceId chain: CEO → C-Level → subordinates.
     // We find the CEO session (waveId timestamp embedded in its ID), then follow dispatch:start events.
-    const streamsDir = path.join(COMPANY_ROOT, 'operations', 'activity-streams');
+    const streamsDir = path.join(COMPANY_ROOT, '.tycono', 'activity-streams');
     if (fs.existsSync(streamsDir)) {
       // Find all activity stream files and check if they belong to this wave
       const waveTimestamp = waveId.replace('wave-', '');
@@ -260,7 +260,7 @@ export function saveCompletedWave(waveId: string, directive: string): { ok: bool
       rolesData.push({ roleId, roleName, sessionId: sid, status, events, childSessions });
     }
 
-    const wavesDir = path.join(COMPANY_ROOT, 'operations', 'waves');
+    const wavesDir = path.join(COMPANY_ROOT, '.tycono', 'waves');
     if (!fs.existsSync(wavesDir)) {
       fs.mkdirSync(wavesDir, { recursive: true });
     }
@@ -325,7 +325,7 @@ export function saveCompletedWave(waveId: string, directive: string): { ok: bool
     if (existingPreset) waveJson.preset = existingPreset;
     fs.writeFileSync(jsonPath, JSON.stringify(waveJson, null, 2), 'utf-8');
 
-    const relativePath = `operations/waves/${baseName}.json`;
+    const relativePath = `.tycono/waves/${baseName}.json`;
     console.log(`[WaveTracker] Wave saved: ${relativePath} (${rolesData.length} roles)`);
 
     // Earn coins for wave completion (non-critical)

package/templates/CLAUDE.md.tmpl

@@ -8,13 +8,13 @@
 
 | Task | Read First | Role |
 |------|-----------|------|
-| Product planning | `projects/` | PM |
-| Technical design | `architecture/` | CTO |
-| Implementation | `projects/*/tasks.md` | Engineer |
-| UI/UX Design | `projects/*/design/` | Designer |
-| Testing/QA | `projects/*/tasks.md` | QA |
-| Operations | `operations/` | PM |
-| Business/Revenue | `company/` | CBO |
+| Product planning | `knowledge/projects/` | PM |
+| Technical design | `knowledge/architecture/` | CTO |
+| Implementation | `knowledge/projects/*/tasks.md` | Engineer |
+| UI/UX Design | `knowledge/projects/*/design/` | Designer |
+| Testing/QA | `knowledge/projects/*/tasks.md` | QA |
+| Operations | `.tycono/` | PM |
+| Business/Revenue | `knowledge/company.md` | CBO |
 | Domain knowledge | `knowledge/` | CBO |
 
 ---
@@ -23,7 +23,7 @@
 
 > **AKB** = A file-based knowledge system where AI uses **search (Grep/Glob)** to find and **contextual links** to navigate
 >
-> Full reference: `methodologies/agentic-knowledge-base.md`
+> Full reference: `knowledge/methodologies/agentic-knowledge-base.md`
 
 | Layer | Role | AI Usage |
 |-------|------|----------|
@@ -203,30 +203,30 @@ After completing any task, check:
 |   +-- preferences.json     <- UI preferences (auto-generated)
 |   +-- custom-rules.md      <- Company custom rules (user owned)
 |   +-- rules-version        <- Current CLAUDE.md version
-+-- company/
-|   +-- company.md           <- Mission, vision, company info
-+-- roles/
-|   +-- roles.md             <- Role listing (Hub)
-|   +-- {role-id}/
-|       +-- role.yaml        <- Role definition
-|       +-- profile.md       <- Role profile
-|       +-- journal/         <- Work journal
-+-- projects/
-|   +-- projects.md          <- Project listing (Hub)
-+-- architecture/
-|   +-- architecture.md      <- Technical architecture (Hub)
-+-- operations/
-|   +-- standup/             <- Daily standups
 |   +-- waves/               <- Wave execution logs
-|   +-- decisions/           <- Decision log
-|   +-- activity-streams/    <- SSE activity event logs
 |   +-- sessions/            <- Session state
+|   +-- standup/             <- Daily standups
+|   +-- activity-streams/    <- SSE activity event logs
 |   +-- cost/                <- Token usage ledger
+|   +-- activity/            <- Activity logs
 +-- knowledge/
 |   +-- knowledge.md         <- Domain knowledge (Hub)
-+-- methodologies/
-|   +-- methodologies.md     <- Methodology listing (Hub)
-|   +-- agentic-knowledge-base.md  <- AKB protocol reference
+|   +-- company.md           <- Mission, vision, company info
+|   +-- roles/
+|   |   +-- roles.md         <- Role listing (Hub)
+|   |   +-- {role-id}/
+|   |       +-- role.yaml    <- Role definition
+|   |       +-- profile.md   <- Role profile
+|   |       +-- journal/     <- Work journal
+|   +-- projects/
+|   |   +-- projects.md      <- Project listing (Hub)
+|   +-- architecture/
+|   |   +-- architecture.md  <- Technical architecture (Hub)
+|   +-- decisions/           <- Decision log
+|   +-- presets/             <- Preset configurations
+|   +-- methodologies/
+|       +-- methodologies.md <- Methodology listing (Hub)
+|       +-- agentic-knowledge-base.md  <- AKB protocol reference
 +-- .claude/skills/
     +-- _shared/             <- Shared skill plugins
     +-- {role-id}/SKILL.md   <- Role-specific skill guides