From 4b71e10d8290a983bf1aaf2248e1e093dc1e332b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fahri=20Can=20Se=C3=A7er?= Date: Fri, 30 Jan 2026 03:39:17 +0300 Subject: [PATCH] main --- mds/2026-01-30-setup-and-docs.md | 28 ++++++++++++++++++++++++++++ prompt.md | 12 +++++++++--- 2 files changed, 37 insertions(+), 3 deletions(-) create mode 100644 mds/2026-01-30-setup-and-docs.md diff --git a/mds/2026-01-30-setup-and-docs.md b/mds/2026-01-30-setup-and-docs.md new file mode 100644 index 0000000..abfc5ea --- /dev/null +++ b/mds/2026-01-30-setup-and-docs.md @@ -0,0 +1,28 @@ +# AI Session Log - 2026-01-30 + +## Overview + +This session focused on improving project documentation and establishing standard practices for AI interactions. + +## 1. API Infrastructure Documentation + +**Request:** Document the technological infrastructure and API service pattern in `src/lib/api/example` within `README.md`. + +**Changes:** +- Updated `README.md` to replace the generic "API Integration" section with a detailed "Standard Architecture" guide. +- Established `src/lib/api/example` as the canonical reference (Golden Standard). +- Defined the 4-layer architecture: Types, Service, Hooks, and Barrel. +- Added code examples for `service.ts` and `use-hooks.ts`. + +## 2. MDS Documentation Standard Setup + +**Request:** Create an `mds` folder and ensure the AI always documents chat and changes there. + +**Changes:** +- Created `mds/` directory. +- Updated `prompt.md` with a new section "📝 AI Documentation (MDS Standard)" to instruct future AI agents to use this folder. +- Created this log file `mds/2026-01-30-setup-and-docs.md` as the first entry. + +## Summary + +The project now has better architectural documentation in the README and a mechanism (via `prompt.md` and `mds/`) to ensure future AI modifications are well-documented. diff --git a/prompt.md b/prompt.md index ab1f496..9e71351 100644 --- a/prompt.md +++ b/prompt.md @@ -8,12 +8,18 @@ 1. **README.md** dosyasını oku - Projenin mimarisi, teknoloji stack'i ve kurulum adımlarını içerir. -``` -README.md -``` +## 📝 AI Documentation (MDS Standard) + +**IMPORTANT:** Every AI session, chat, or major change MUST be documented in the `mds/` folder. + +1. **Create/Update Log:** Create a markdown file (e.g., `mds/YYYY-MM-DD-topic.md`) or append to an existing daily log. +2. **Content:** Briefly summarize the user request, the changes made, and the rationale. +3. **Persistence:** This ensures a history of AI interactions and decisions is preserved within the repo. --- +## 📚 Projeyi Anlamak İçin Önce Oku + ## 🎯 Referans Klasörü `.claude/` klasörü best practice'ler, agent tanımları ve yardımcı scriptler içerir. Görev türüne göre ilgili referansları kullan: