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:
@@ -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.
|
||||
|
||||
---
|
||||
Reference in New Issue
Block a user