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,43 +1,53 @@
# Collab Intake System
# Intake Directory
This directory contains the collaborative intake system for populating and updating the databank through structured interviews and workflows.
This directory contains structured intake templates and responses for comprehensive information gathering.
## Purpose
- **Structured Collection**: Formal templates for gathering comprehensive information
- **Consistent Updates**: Standardized approach to updating databank content
- **Complete Coverage**: Ensure all relevant information captured during updates
## Structure
```
intake/
├── templates/ # Interview templates and question sets
├── responses/ # Collected responses from interviews
── workflows/ # Automated intake workflows and processes
└── README.md # This file
├── templates/ # Structured intake templates
├── responses/ # Completed intake responses
── README.md # This file
```
## Purpose
## Workflow
The intake system facilitates:
- Structured knowledge capture through guided interviews
- Regular updates to keep databank information current
- Multi-modal input collection (text, voice, structured data)
- Quality control and validation of incoming information
- Automated synchronization between human and LLM formats
## Process
1. **Templates** - Use predefined interview templates for specific domains
2. **Interviews** - Conduct structured interviews using templates
3. **Responses** - Collect and store raw responses
4. **Processing** - Convert responses into both human and LLM formats
5. **Validation** - Review and validate converted information
6. **Synchronization** - Update both human and LLM directories
7. **Tracking** - Maintain version history and change tracking
1. **Template Selection**: Choose appropriate template for update type
2. **Information Gathering**: Conduct structured interview using template
3. **Response Recording**: Record responses in responses/ directory
4. **Processing**: AI processes responses and updates databank/artifacts/
5. **Validation**: Review and confirm updates to databank/artifacts/
## Templates
Template files guide the intake process with:
- Domain-specific questions
- Response format guidelines
- Validation criteria
- Cross-reference requirements
- Update frequency recommendations
Common intake templates include:
- **Personal Information**: Updates to biographical and preference information
- **AI Tools and Preferences**: Changes to tool usage and agent guidelines
- **Operational Procedures**: Updates to workflows and processes
- **Project Information**: New projects or updates to existing projects
- **Relationship Changes**: Updates to professional networks and collaborations
## Guidelines
### For Humans
- **Use Appropriate Template**: Select template matching update type
- **Be Comprehensive**: Provide complete information when responding
- **Follow Structure**: Maintain template format for easy processing
- **Be Accurate**: Provide current and accurate information
### For AI Agents
- **Guide Through Process**: Help humans complete templates accurately
- **Clarify Questions**: Explain ambiguous template items
- **Validate Responses**: Ensure responses are complete and consistent
- **Process Thoroughly**: Convert responses to appropriate databank updates
- **Maintain History**: Track changes and updates over time
---