progress snapshot

This commit is contained in:
2025-10-25 16:28:14 -05:00
parent 2856291020
commit 6028ef5063
23 changed files with 871 additions and 1137 deletions

View File

@@ -1,9 +1,9 @@
{
"title": "AGENTS.md - Guidelines for AI Agents in Restructured AI Home Directory",
"timestamp": "2025-10-24T10:50:00Z",
"version": "10.0.0",
"summary": "Comprehensive guidelines for AI agents operating within the AI home directory environment with separated databank and PMO components",
"categories": ["guidelines", "principles", "workflow", "best-practices"],
"title": "GLOBAL-RULES.md - Global Guidelines for AI Agents Across All Projects",
"timestamp": "2025-10-24T12:00:00Z",
"version": "12.0.0",
"summary": "Comprehensive guidelines for AI agents operating within the AI home directory environment with separated databank and PMO components, including intake processing workflow",
"categories": ["guidelines", "principles", "workflow", "best-practices", "intake-processing"],
"core_principles": {
"context_awareness": {
"description": "Operating within mounted AI home directory with separated databank (readonly) and PMO (read-write)",
@@ -29,35 +29,10 @@
"repository_management": {
"structure_requirements": {
"databank": {
"description": "Readonly context (do not modify except in designated areas)",
"directories": [
{"name": "databank/personal/", "purpose": "Personal information"},
{"name": "databank/agents/", "purpose": "Agent guidelines and tools"},
{"name": "databank/operations/", "purpose": "Operational environment information"},
{"name": "databank/coo/", "purpose": "Chief Operating Officer domain"},
{"name": "databank/cto/", "purpose": "Chief Technology and Product Officer domain"},
{"name": "databank/cto/vpengineering/", "purpose": "VP Engineering focus area"},
{"name": "databank/cto/vpproduct/", "purpose": "VP Product focus area"},
{"name": "databank/templates/", "purpose": "Template files for projects"},
{"name": "databank/collab/", "purpose": "Human/AI interaction space"},
{"name": "databank/artifacts/", "purpose": "AI-managed content"}
]
"description": "Readonly context (do not modify except in designated areas)"
},
"pmo": {
"description": "Read-write project management (updates allowed here)",
"directories": [
{"name": "pmo/artifacts/dashboard/", "purpose": "Dashboard views"},
{"name": "pmo/artifacts/projects/", "purpose": "Project registry and tracking"},
{"name": "pmo/artifacts/reports/", "purpose": "Status reports"},
{"name": "pmo/artifacts/resources/", "purpose": "Resource management"},
{"name": "pmo/artifacts/config/", "purpose": "Configuration"},
{"name": "pmo/artifacts/docs/", "purpose": "Documentation"},
{"name": "pmo/coo/", "purpose": "COO-specific project management"},
{"name": "pmo/cto/", "purpose": "CTO-specific project management"},
{"name": "pmo/cto/vpengineering/", "purpose": "VP Engineering project management"},
{"name": "pmo/cto/vpproduct/", "purpose": "VP Product project management"},
{"name": "pmo/collab/", "purpose": "PMO-specific collaboration"}
]
"description": "Read-write project management (updates allowed here)"
},
"git_practices": [
"Use conventional commits (chore:, feat:, docs:, fix:, etc.)",
@@ -71,6 +46,47 @@
"collab_readonly": "Access for reference, no modifications in active projects"
}
},
"intake_processing_workflow": {
"description": "Global standard for intake processing (implementation may vary by project)",
"steps": [
{
"step": 1,
"action": "Identify Source Content",
"description": "Locate new files in the intake directory"
},
{
"step": 2,
"action": "Process into Artifacts",
"description": "Create both human and LLM format versions in appropriate databank/artifacts subdirectories"
},
{
"step": 3,
"action": "Archive Originals",
"description": "Create archive directory using current timestamp structure archive/YYYY/MM/DD/HHMM and move original intake files there"
},
{
"step": 4,
"action": "Update TOC",
"description": "Ensure LLMDatabankTOC.json reflects the current artifact files"
},
{
"step": 5,
"action": "Template Completion",
"description": "If a PERSONAL_INFO_TEMPLATE.md is processed with blank sections, create a new template file with those sections filled in using a -YYYY-MM-DD-HHMM.md suffix"
}
],
"format_requirements": {
"human_format": "Beautiful, well-structured markdown files for human readability",
"llm_format": "Structured JSON data optimized for LLM processing and retrieval",
"synchronization": "Both formats must contain the same information, just in different structures"
},
"directory_structure": {
"intake_directory": "databank/collab/intake/ - Input files for processing",
"archive_directory": "databank/collab/intake/archive/YYYY/MM/DD/HHMM/ - Archived processed files",
"human_artifacts": "databank/artifacts/human/ - Human-readable versions",
"llm_artifacts": "databank/artifacts/llm/ - LLM-optimized versions"
}
},
"development_workflow": {
"pre_work_checklist": [
"Read project-specific documentation first",
@@ -257,5 +273,14 @@
"codex": "Primary daily driver (subscription-based), best for code generation and completion",
"qwen": "Heavy system orchestration, excels at shell/Docker operations",
"gemini": "Primarily used for audits and analysis"
},
"metadata": {
"processing_notes": "Includes intake processing workflow rules implemented during 2025-10-24 session",
"version_history": [
{"version": "11.0.0", "date": "2025-10-24", "change": "Add intake processing workflow and process rules"},
{"version": "10.0.0", "date": "2025-10-24", "change": "Add deconfliction protocol and update date format"},
{"version": "9.0.0", "date": "2025-10-24", "change": "Add CTO structure and AI persona guidelines"},
{"version": "8.0.0", "date": "2025-10-24", "change": "Update for COO transition and PMO structure updates"}
]
}
}