fix: correct databank architecture and implement proper CTO/COO structure\n\n- Remove incorrectly placed human/llm directories from databank root\n- Restructure databank with everything under databank/artifacts/ as requested\n- Implement proper CTO/COO structure under pmo/artifacts/ with complete PMO components\n- Create comprehensive collab/ directory structure for human/AI communication\n- Remove Joplin processing scripts and references as requested\n- Create proper scaffolding directories for quick domain standup\n- Update README documentation to reflect corrected architecture\n- Ensure only collab/ directories are editable by humans\n- AI agents manage databank/artifacts/ based on collab/ communications\n- Create structured intake templates and collaboration workflows\n- Maintain clear separation between readonly databank and read-write PMO\n- Implement proper single source of truth with AI-managed artifacts

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
2025-10-24 12:38:23 -05:00
parent 919349aad2
commit a811335196
32 changed files with 941 additions and 1037 deletions

View File

@@ -1,12 +1,78 @@
# Databank Collaboration Directory
This directory is designated for human/AI interaction and communication within the databank.
This directory is the exclusive space for human/AI collaboration and communication regarding databank content.
## Purpose
- Spaces for communication between Charles and AI agents
- Temporary files for collaborative work
- Discussion documents and notes
- Joint planning artifacts
- **Exclusive Communication Channel**: All human/AI interaction about databank content occurs here
- **Content Ingestion**: Joplin markdown exports and other content sources
- **Structured Intake**: Formal interviews and information gathering
- **Request and Proposal System**: Questions → Proposals → Implementation workflow
- **Temporary Collaboration Files**: Working documents and drafts
This directory allows for interaction while maintaining the readonly nature of the rest of the databank.
## Workflow
### 1. Content Ingestion
```
Human: "Please ingest this Joplin note about my new project"
AI: Processes note and updates databank/artifacts/ appropriately
```
### 2. Structured Requests
```
Human: "I need to update my AI tool preferences"
AI: Creates intake template, conducts structured interview
Human: Completes interview with current information
AI: Updates databank/artifacts/ with new information
```
### 3. Ad-hoc Communication
```
Human: "Question about current databank structure"
AI: Responds with information and/or creates proposal
Human: Reviews proposal and provides feedback
AI: Implements changes to databank/artifacts/ as needed
```
## Structure
```
collab/
├── fromjoplin/ # Joplin markdown exports for ingestion
├── intake/ # Structured intake responses and templates
├── proposals/ # Formal proposals for databank changes
├── questions/ # Questions requiring AI responses
├── drafts/ # Working documents and drafts
└── README.md # This file
```
## Guidelines
### For Humans
- **Only edit this directory** - Never edit databank/artifacts/ directly
- **Use structured templates** when available for consistent intake
- **Follow question → proposal → implementation workflow**
- **Drop Joplin exports in fromjoplin/** for automatic processing
- **Be explicit about desired changes** to databank content
### For AI Agents
- **Monitor this directory continuously** for new content and requests
- **Process Joplin exports** in fromjoplin/ and update databank/artifacts/
- **Conduct structured interviews** using templates in intake/
- **Create formal proposals** for significant databank changes
- **Only update databank/artifacts/** - never edit this collab/ directory
- **Maintain clear audit trail** of all changes made to databank/artifacts/
## Communication Protocol
1. **Primary Channel**: This collab/ directory for all human/AI interaction
2. **Question Workflow**: Use questions/ directory for inquiries
3. **Proposal Process**: Use proposals/ directory for significant changes
4. **Content Updates**: Drop exports in fromjoplin/ for ingestion
5. **Structured Intake**: Use intake/ templates for comprehensive updates
## Note
This directory is the **only** place where humans should directly edit files. The AI agents are responsible for processing content from this directory and updating the canonical databank/artifacts/ directory accordingly.
---