data/HOW_TO_UPDATE_DATA.md

How to Update ArunCore Knowledge Data

ArunCore uses a modular single-source-of-truth structure for your project data.

---

📁 Data Structure Overview

data/
├── static/
│   ├── public_profile.md         # Your core identity, principles, vision & loop
│   └── rules_of_engagement.md   # LLM guidelines & zero-hallucination rules
│
└── github/                        # ONE clean folder per GitHub project
    ├── <project_name>/
    │   ├── README.md              # Project overview, tech stack, & direct GitHub URL link
    │   └── metadata.json          # Structured metadata (URL, stack, stars, topics)
    └── ...

---

🚀 How to Add or Update a Project

Option A: Automatic GitHub Sync (Recommended)

Run the automated sync script to pull your latest READMEs and GitHub URLs directly from your GitHub profile (neural-arun):

python scripts/sync_github_data.py

Option B: Manual Add

1. Create a new folder under data/github/<your_repo_name>/.
2. Place your project README.md and metadata.json inside it.
3. Make sure README.md starts with a link header:

   > **GitHub Repository:** [https://github.com/neural-arun/your_repo_name](https://github.com/neural-arun/your_repo_name)
   

---

🔄 Re-Ingest into Vector DB

After adding or modifying files in data/:

python core/ingest.py

ingest.py incrementally updates ChromaDB so your agent instantly gains access to the new knowledge.