feat: add databank collab and artifacts structure with updated workflows\n\n- Create databank/collab directory for human/AI interaction\n- Create databank/artifacts directory with subdirs (docs, code, config, templates)\n- Update AGENTS.md to clarify collab/ for human/AI interaction and artifacts/ fully managed by AI\n- Replace old output/ references with new artifacts/ structure in AGENTS.md\n- Update main README.md with new databank structure and clickable links\n- Add documentation for both new databank directories\n- Update AGENTS.md version tracking to v5.0.0 reflecting the new structure\n- Maintain consistency across all references to AI-managed vs human-managed spaces
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
30
README.md
30
README.md
@@ -75,8 +75,14 @@ AI-Home-Directory/ # Mount point in containers
|
|||||||
│ │ └── PROJECT-MGMT-TOOLS.md
|
│ │ └── PROJECT-MGMT-TOOLS.md
|
||||||
│ ├── operations/ # Operational environment information
|
│ ├── operations/ # Operational environment information
|
||||||
│ │ └── OPERATIONS-KNOWLEDGE-TRANSFER.md
|
│ │ └── OPERATIONS-KNOWLEDGE-TRANSFER.md
|
||||||
│ └── templates/ # Template files for projects
|
│ ├── templates/ # Template files for projects
|
||||||
│ └── OPS-ENVIRONMENT.md
|
│ │ └── 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)
|
├── pmo/ # ✏️ Read-write PMO (mounted read-write)
|
||||||
│ ├── artifacts/ # PMO components and data
|
│ ├── artifacts/ # PMO components and data
|
||||||
│ │ ├── dashboard/ # PMO dashboard views
|
│ │ ├── 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 |
|
| [**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*
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -5,6 +5,7 @@ Friday, October 24, 2025 (Timezone: UTC+00:00 - Please adjust to local system ti
|
|||||||
|
|
||||||
| Date | Version | Description | Author |
|
| 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 | 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 | 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) |
|
| 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 |
|
| 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 | 4.0.0 | Updated PMO structure and documentation links |
|
||||||
| 2025-10-24 | 3.0.0 | Added guidelines for gorgeous commit messages |
|
| 2025-10-24 | 3.0.0 | Added guidelines for gorgeous commit messages |
|
||||||
| 2025-10-24 | 2.0.0 | Updated for databank/PMO restructure |
|
| 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
|
- Maintain consistency in behavior across different projects
|
||||||
- Respect environment-specific configurations
|
- 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
|
### Tool Integration
|
||||||
- Work with existing development tools and workflows
|
- Work with existing development tools and workflows
|
||||||
- Maintain compatibility with CI/CD pipelines
|
- Maintain compatibility with CI/CD pipelines
|
||||||
|
|||||||
12
databank/artifacts/README.md
Normal file
12
databank/artifacts/README.md
Normal file
@@ -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.
|
||||||
12
databank/collab/README.md
Normal file
12
databank/collab/README.md
Normal file
@@ -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.
|
||||||
Reference in New Issue
Block a user