diff --git a/README.md b/README.md index 44da8dc..844fd51 100644 --- a/README.md +++ b/README.md @@ -75,8 +75,14 @@ AI-Home-Directory/ # Mount point in containers │ │ └── PROJECT-MGMT-TOOLS.md │ ├── operations/ # Operational environment information │ │ └── OPERATIONS-KNOWLEDGE-TRANSFER.md -│ └── templates/ # Template files for projects -│ └── OPS-ENVIRONMENT.md +│ ├── templates/ # Template files for projects +│ │ └── OPS-ENVIRONMENT.md +│ ├── collab/ # Human/AI interaction space +│ └── artifacts/ # AI-managed content and resources +│ ├── docs/ # AI-managed documentation +│ ├── code/ # AI-managed code artifacts +│ ├── config/ # AI-managed configuration +│ └── templates/ # AI-managed templates ├── pmo/ # ✏️ Read-write PMO (mounted read-write) │ ├── artifacts/ # PMO components and data │ │ ├── dashboard/ # PMO dashboard views @@ -143,7 +149,25 @@ The databank directory contains readonly information that provides consistent co |------|---------| | [**OPERATIONS-KNOWLEDGE-TRANSFER.md**](./databank/operations/OPERATIONS-KNOWLEDGE-TRANSFER.md) | Knowledge transfer interview for operational roles | -*Note: All databank files are readonly for AI agents* +### Templates (`databank/templates/`) +| File | Purpose | +|------|---------| +| [**OPS-ENVIRONMENT.md**](./databank/templates/OPS-ENVIRONMENT.md) | Operational environment template | + +### Collaboration (`databank/collab/`) +| Directory | Purpose | +|-----------|---------| +| [**databank/collab/**](./databank/collab/) | Space for human/AI interaction | + +### Artifacts (`databank/artifacts/`) +| Directory | Purpose | +|-----------|---------| +| [**databank/artifacts/docs/**](./databank/artifacts/docs/) | AI-managed documentation | +| [**databank/artifacts/code/**](./databank/artifacts/code/) | AI-managed code artifacts | +| [**databank/artifacts/config/**](./databank/artifacts/config/) | AI-managed configuration | +| [**databank/artifacts/templates/**](./databank/artifacts/templates/) | AI-managed templates | + +*Note: All databank files are readonly for AI agents except in collab/ and artifacts/ directories* --- diff --git a/databank/agents/AGENTS.md b/databank/agents/AGENTS.md index c954a45..129a776 100644 --- a/databank/agents/AGENTS.md +++ b/databank/agents/AGENTS.md @@ -5,6 +5,7 @@ Friday, October 24, 2025 (Timezone: UTC+00:00 - Please adjust to local system ti | Date | Version | Description | Author | |------------|---------|--------------------------------------------------|---------------------| +| 2025-10-24 | 5.0.0 | Add databank collab and artifacts structure | Charles N Wyble (@ReachableCEO) | | 2025-10-24 | 4.0.0 | Update PMO structure and documentation links | Charles N Wyble (@ReachableCEO) | | 2025-10-24 | 3.0.0 | Add guidelines for gorgeous commit messages | Charles N Wyble (@ReachableCEO) | | 2025-10-24 | 2.0.0 | Update for databank/PMO restructure | Charles N Wyble (@ReachableCEO) | @@ -14,6 +15,7 @@ Friday, October 24, 2025 (Timezone: UTC+00:00 - Please adjust to local system ti | Date | Version | Description | |------------|---------|--------------------------------------------------| +| 2025-10-24 | 5.0.0 | Added databank collab and artifacts structure | | 2025-10-24 | 4.0.0 | Updated PMO structure and documentation links | | 2025-10-24 | 3.0.0 | Added guidelines for gorgeous commit messages | | 2025-10-24 | 2.0.0 | Updated for databank/PMO restructure | @@ -202,6 +204,16 @@ Friday, October 24, 2025 (Timezone: UTC+00:00 - Please adjust to local system ti - Maintain consistency in behavior across different projects - Respect environment-specific configurations +### Collaboration and Artifacts +- Use `databank/collab/` for human/AI interaction and communication +- Use `databank/artifacts/` for AI-managed content (docs, code, config, templates) +- AI has full management control over `databank/artifacts/` directory +- Human interaction primarily occurs in `databank/collab/` directory +- The AI manages the `databank/artifacts/` directory structure as needed +- Common pattern: `databank/artifacts/docs/`, `databank/artifacts/code/`, `databank/artifacts/config/`, etc. +- Maintain clean separation between human-managed and AI-managed resources +- Follow consistent naming conventions across artifacts + ### Tool Integration - Work with existing development tools and workflows - Maintain compatibility with CI/CD pipelines diff --git a/databank/artifacts/README.md b/databank/artifacts/README.md new file mode 100644 index 0000000..436f8ee --- /dev/null +++ b/databank/artifacts/README.md @@ -0,0 +1,12 @@ +# Databank Artifacts Directory + +This directory is fully managed by AI agents as they see fit for storing various artifacts. + +## Purpose + +- AI-managed documentation ([docs/](./docs/)) +- AI-managed code artifacts ([code/](./code/)) +- AI-managed configuration ([config/](./config/)) +- AI-managed templates ([templates/](./templates/)) + +The AI has complete control over this directory and can organize, create, modify, and delete content as needed to support various functions and operations. \ No newline at end of file diff --git a/databank/collab/README.md b/databank/collab/README.md new file mode 100644 index 0000000..5e14472 --- /dev/null +++ b/databank/collab/README.md @@ -0,0 +1,12 @@ +# Databank Collaboration Directory + +This directory is designated for human/AI interaction and communication within the databank. + +## Purpose + +- Spaces for communication between Charles and AI agents +- Temporary files for collaborative work +- Discussion documents and notes +- Joint planning artifacts + +This directory allows for interaction while maintaining the readonly nature of the rest of the databank. \ No newline at end of file