V2_README.md

AI_CORE Version 2 (V2)

Summary

Version 2 (V2) of AI_CORE further enhances the organizational structure by introducing a hidden .ai_core folder at the project root. This folder contains dedicated subfolders for core directives, contextual memory, toolbox utilities, and project history. The previous structure of README.md and TASKS.md in each folder is retained.

Key Features

• README.md in Each Folder: Maintains context, state, and information.
• TASKS.md in Each Folder: Tracks tasks and actionable items.
• .ai_core Folder: Centralizes core project components for advanced contextual management:
  • core_directives/: Stores guiding principles, rules, and high-level instructions. README.md information is broken up and transferred here as individual files for modularity.
  • core_contextual_memory/: Contains files for persistent contextual data, memory, and associative knowledge. New concepts or ideas surfaced through reasoning are documented here.
  • core_toolbox/: Houses scripts, utilities, and tools for project operations. If a required script/tool does not exist, it is created here and referenced in documentation and memory.
  • core_history/: Archives logs, change history, and important events.
• Improved Modularity: Separates core logic and memory from general documentation and tasks.
• FSM and TASKS Management: FSM.md and TASKS.md are defined and maintained for workflow and task tracking.
• Atom of Thought Reasoning: A process for organizing thoughts, ideas, concepts, or definitions. Each is documented as an 'atom' and free association is used to surface new ideas, which are then recorded in core_contextual_memory.
• Commit Discipline: All work is committed with detailed summaries, ensuring the codebase is never left in a broken state.
• Knowledge Embedding: The goal is to embed knowledge and associative data for later reuse, making the project self-documenting and context-rich.

Setup / Init Block

To initialize a V2 AI_CORE project:

1. Create a hidden .ai_core folder at the project root.
2. Inside .ai_core, create the following subfolders:
   • core_directives/
   • core_contextual_memory/
   • core_toolbox/
   • core_history/
3. Transfer and break up existing README.md information into individual files in core_directives/.
4. Create TASKS.md and FSM.md in the project root or in .ai_core as needed for task and workflow management.
5. As new concepts or associations arise (via Atom of Thought reasoning), document them in core_contextual_memory/.
6. If a new tool or script is needed, create it in core_toolbox/ and update documentation and memory accordingly.
7. Ensure all changes are committed with detailed summaries and the codebase remains stable.

Atom of Thought Reasoning

• Each thought, idea, concept, or definition is treated as an 'atom' and documented.
• Free association is used to explore connections between atoms, surfacing new ideas.
• New concepts are recorded in core_contextual_memory/ for future reference and reuse.

Example Directory Structure

.ai_core/
  core_directives/
    [guiding_principle_1].md
    [guiding_principle_2].md
    ...
  core_contextual_memory/
    [concept_1].md
    [concept_2].md
    ...
  core_toolbox/
    [utility_script_1].py
    ...
  core_history/
    [log_YYYYMMDD].md
FSM.md
TASKS.md
README.md (in each folder)

TASKS.md and FSM.md

• TASKS.md: Tracks actionable items, progress, and outstanding work for the project.
• FSM.md: Documents the finite state machine guiding the AI workflow, including state transitions and logic.

---

This document summarizes the V2 structure, setup/init process, Atom of Thought reasoning, and philosophy for AI_CORE.

Related Files

• V2_TASKS.md: Tracks actionable items, progress, and outstanding work for V2.
• V2_FSM.md: Documents the finite state machine guiding the V2 AI workflow, including state transitions and logic.