AI_CORE

Quick Start

1. See INSTALL_OR_USE.md for setup and usage instructions.
2. Choose a version from the Versions/ directory that fits your needs.
3. For V2 and above, ensure the .ai_core directory exists at the project root (it may be empty until populated by the system or user).

Version Comparison Table

Version	Key Features	.ai_core Support	Self-Modifying Directives
V0	README.md in each folder, simple context tracking	No	No
V1	Adds TASKS.md, FSM workflow	No	No
V2	Adds .ai_core (directives, memory, toolbox, history), Atom of Thought reasoning	Yes	No
V3	Self-modifying directives, multi-perspective vetting, enhanced FSM	Yes	Yes

Glossary

• README.md: Context and documentation for each folder or version.
• TASKS.md: Tracks actionable items and progress.
• FSM.md: Documents the finite state machine guiding workflow.
• .ai_core: Root folder (V2+) for core directives, contextual memory, tools, and history.
• Atom of Thought: Reasoning process for surfacing and documenting new concepts.
• Self-Modifying Directives: System can propose, vet, and commit changes to its own rules (V3).

FAQ

Q: What if my .ai_core folders are empty? A: This is normal for new setups. The folders are populated as you add directives, memory, tools, or logs.

Q: How do I add a new directive or tool? A: Place a new file in the appropriate .ai_core subfolder (e.g., core_directives/ for rules, core_toolbox/ for scripts).

Q: Which version should I use? A: See the version comparison table above and the INSTALL_OR_USE.md for guidance.

AI_CORE is a modular, evolving framework for contextual information association, knowledge management, and AI-driven reasoning. The project is structured into distinct versions, each building on the last, and is designed for use with modern editors like Cursor or VSCode.

Project Philosophy

AI_CORE aims to:

• Store and organize contextual information in a human-readable, extensible way
• Enable associations, reasoning, and workflow automation
• Support self-improvement and knowledge embedding through versioned evolution

Versioned Architecture

The Versions/ directory contains documentation and specifications for each major version of AI_CORE. Each version introduces new features and organizational strategies:

Version 0 (V0)

• README.md in Each Folder: Serves as the primary source of truth for state and information.
• Simple, Human-Readable Documentation: All context and updates are maintained in Markdown format.
• Task Completion Workflow: Tasks and their completion records are tracked in the README.md.
• See V0_README.md for full details.

Version 1 (V1)

• README.md in Each Folder: Maintains context and information.
• TASKS.md in Each Folder: Tracks actionable items and progress.
• Finite State Machine (FSM): Guides the AI workflow for robust, recoverable, and structured task management.
• See V1_README.md, V1_TASKS.md, and V1_FSM.md.

Version 2 (V2)

• .ai_core Folder: Centralizes core project components for advanced contextual management:
  • core_directives/: Guiding principles and high-level instructions
  • core_contextual_memory/: Persistent contextual data and associative knowledge
  • core_toolbox/: Scripts, utilities, and tools
  • core_history/: Logs and change history
• Atom of Thought Reasoning: Organizes and free-associates ideas, documenting new concepts in contextual memory.
• Commit Discipline: All work is committed with detailed summaries, ensuring a stable codebase.
• See V2_README.md, V2_TASKS.md, and V2_FSM.md.

Version 3 (V3)

• Self-Modifying Directives: The system can propose, vet, and commit changes to its own directives, with multi-perspective assessment and safeguards.
• Enhanced FSM and Task Management: Inherits all V2 features and adds robust self-review.
• See V3_README.md, V3_TASKS.md, V3_FSM.md, and V3_DRIECTIVE_SELF_MOD.md.

The .ai_core Directory

Located at the project root, .ai_core contains:

• core_directives/: Modular directive files (may be empty until populated by the system)
• core_contextual_memory/: Associative/contextual knowledge (may be empty initially)
• core_toolbox/: Scripts and utilities (may be empty initially)
• core_history/: Logs and change history (may be empty initially)

How to Use

1. Choose a Version: Review the Versions/ directory and select the version that fits your needs.
2. Follow Setup Instructions: Each version's README.md provides setup and usage details.
3. Leverage .ai_core: For V2 and above, use the .ai_core folder for advanced context, tools, and memory.
4. Contribute and Extend: Add new directives, tools, or memory as your project evolves.

Contributing

Contributions are welcome! Please open issues or pull requests to discuss ideas or improvements.

---

For detailed version documentation, see the Versions/ directory. For advanced context and tools, see the .ai_core folder (V2+).