Add context builder and development notes

Author: itsflaid

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

.gitattributes

@@ -0,0 +1,2 @@
+# Keep repository text files consistent across operating systems.
+* text=auto eol=lf

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "files.eol": "\n"
+}

AGENTS.md

@@ -1,21 +1,43 @@
-# DevMap — Agent 
-
-read PRD and all documentation first before hands-on.
- 
-## Relevant Skills
-
-ECC skills are stored in `.agents/skills/`.
-
-Use these when relevant:
-
-- `coding-standards` — code quality and consistency.
-- `verification-loop` — build, lint, typecheck, test, manual verification.
-- `documentation-lookup` — check current library docs instead of guessing.
-- `backend-patterns` — service/repository/validation patterns.
-- `deep-research` — research parser/framework/library behavior.
-- `security-review` — secrets, command execution, file access, user input.
-- `tdd-workflow` — tests for new analyzers and bug fixes.
-- `eval-harness` — benchmark DevMap output on sample repositories.
-- `strategic-compact` — keep long agent sessions manageable.
-- `agent-introspection-debugging` — recover when the agent loops or gets stuck.
-
+# DevMap — Agent
+
+read PRD and all documentation first before hands-on.
+
+## Source of Truth
+
+The PRD is the source of truth for product behavior, requirements, and priorities.
+
+If there is any conflict between the PRD and other documents (README, docs, comments, plans, or specifications), follow the PRD.
+
+## Relevant Skills
+
+ECC skills are stored in `.agents/skills/`.
+
+Use these when relevant:
+
+- `coding-standards` — code quality and consistency.
+- `verification-loop` — build, lint, typecheck, test, manual verification.
+- `documentation-lookup` — check current library docs instead of guessing.
+- `backend-patterns` — service/repository/validation patterns.
+- `deep-research` — research parser/framework/library behavior.
+- `security-review` — secrets, command execution, file access, user input.
+- `tdd-workflow` — tests for new analyzers and bug fixes.
+- `eval-harness` — benchmark DevMap output on sample repositories.
+- `strategic-compact` — keep long agent sessions manageable.
+- `agent-introspection-debugging` — recover when the agent loops or gets stuck.
+
+## Personal Development Documentation
+
+Keep the private development notes under `docs/for-me-personal/` current while
+working on DevMap.
+
+- Record completed work, current status, important decisions, and remaining
+  tasks in `docs/for-me-personal/PROGRESS.md`.
+- Record the latest development testing commands, prerequisites, expected
+  results, manual test flows, and cross-platform verification steps in
+  `docs/for-me-personal/TEST.md`.
+- Record meaningful debugging incidents in `docs/for-me-personal/DEBUG.md`,
+  including the symptom, root cause, solution, verification, and lesson learned.
+
+Update the relevant document whenever implementation or verification changes
+its contents. Do not duplicate these personal notes into the public `docs/`
+folder unless the information is intended for users or contributors.