78 lines
3.0 KiB
Markdown
78 lines
3.0 KiB
Markdown
# Databank Collaboration Directory
|
|
|
|
This directory is the exclusive space for human/AI collaboration and communication regarding databank content.
|
|
|
|
## Purpose
|
|
|
|
- **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
|
|
|
|
## 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.
|
|
|
|
--- |