Skip to content
FSS Knowledge Base

Ongoing Projects Structure — Session Log

Section titled “Ongoing Projects Structure — Session Log”

What Was Decided

Section titled “What Was Decided”

Ongoing project standard structure:

[project]/
├── AGENTS.md    ← SSOT for all LLMs (or pointer to CLAUDE.md for existing projects)
├── CLAUDE.md    ← Claude Code context (full SSOT for existing; thin wrapper for new)
├── GEMINI.md    ← Gemini CLI thin wrapper
├── README.md    ← human-first docs
├── CHANGELOG.md ← date-based history
├── LESSONS.md   ← non-obvious gotchas
└── [source/]

Multi-LLM pattern: AGENTS.md is the universal SSOT for new projects. For existing projects with substantial CLAUDE.md, AGENTS.md is a pointer + summary; GEMINI.md references both. Future: migrate existing CLAUDE.mds → AGENTS.md.

Bidirectional KB links: KB note in Core/IT/Utils/[dept]/[ProjectName].md ↔ project README.

What Changed

Section titled “What Changed”

KB vault:

  • Core/Processes/KB-Obsidian/ → Core/Processes/KB-OS/ (folder + all refs updated)
  • Core/UPGRADES.md → Core/Processes/KB-OS/UPGRADES.md
  • Core/AI/ — all numeric prefixes removed (01_–08_ → semantic names)
  • Core/AI/AI-config.md created (KB portal for ai-config project)
  • Core/IT/Utils/Custom/ — web-deploy.md, Focus-Pages.md created; My_Backup System.md updated

Skills:

  • 4 stale skills fixed (session-continue, session-save, research, task-from-chat) — hardcoded KB/Business/ paths
  • tmp-do command deleted (redundant with /task-start _tmp.md)
  • /setup-ongoing-project skill created
  • Skills Dashboard updated (2026-06-15)
  • CLAUDE.md: Dashboard update rule + stale-path audit reminder added

Projects scaffolded (AGENTS.md + GEMINI.md + LESSONS.md):

  • ~/ai-config/ (renamed from config-ai; CLAUDE.md source reconciled with deployed)
  • ~/utils/web/web-deploy/
  • ~/projects/monorepo/
  • /mnt/d/FSS/Software/Utils/PythonUtils/my_backup/

Committed: KB vault f2671c0, ai-config 3156b2d, web-deploy 3d6419e, monorepo 88f40af, my_backup f0e3590

Warnings / Gotchas

Section titled “Warnings / Gotchas”
  • After any KB vault restructure: grep -r 'old-path' ~/.claude/skills/ ~/.claude/commands/ — skills silently break with stale hardcoded paths
  • ai-config post-commit hook used ~/config-ai/deploy.sh (tilde notation) — sed with absolute path didn’t match; fixed by overwriting hook with printf
  • Focus-Pages deferred: spans KB + monorepo, needs separate task

Deferred

Section titled “Deferred”
  • JOB_DESCRIPTION.md scope for all depts → Core/Processes/KB-OS/UPGRADES.md
  • Focus-Pages ongoing project structure → separate task
  • Skills Dashboard uncategorized section (6 items)