Files
memex/notes/dotemacs.org

57 lines
2.0 KiB
Org Mode

#+TITLE: SKILL: Dotemacs Configuration (Universal Literate Note)
#+ID: skill-dotemacs
#+STARTUP: content
#+FILETAGS: :emacs:config:literate:psf:
* Overview
The **Dotemacs** project represents the "Operating System" configuration. It transforms Emacs into the primary computing tool by leveraging modular, literate Org-mode files that tangle into a high-performance environment.
* Phase A: Demand (PRD)
:PROPERTIES:
:STATUS: FROZEN
:END:
** 1. Purpose
Define the requirements for a modular, optimized, and fully documented Emacs environment.
** 2. User Needs
- **Modularity:** Split the monolithic `emacs.org` into functional modules (core, ui, gtd, ai, etc.).
- **Literate Mandate:** Every significant setting must be justified and explained in prose.
- **Integration:** Seamless connectivity with `org-agent`, `org-roam`, and `org-gtd`.
- **Bootstrapping:** Fast startup using `early-init.el` and lazy-loading.
** 3. Success Criteria
*** TODO Monolithic modularization completion
*** TODO Standardize all paths to ~/memex/
*** TODO Ensure Org 10.0-pre bootstrap compatibility
*** TODO Document all major package configurations
* Phase B: Blueprint (PROTOCOL)
:PROPERTIES:
:STATUS: SIGNED
:END:
** 1. Architectural Intent
The configuration is structured as a collection of feature-specific Org files that tangle into the `~/.emacs.d/` directory.
** 2. Semantic Interfaces
#+begin_src elisp
(defun dotemacs-tangle-module (module-name)
"Tangels a specific module Org file into its .el counterpart.")
(defun dotemacs-verify-load-path ()
"Ensures all Memex paths are correctly registered in the load-path.")
#+end_src
* Phase D: Build (Implementation)
The implementation is distributed across the `emacs-*.org` files in `projects/dotemacs/`.
** Core Module Tangle
#+begin_src elisp
;; Example tangle header
;; #+PROPERTY: header-args:elisp :tangle ~/.emacs.d/lisp/core.el
#+end_src
* Phase E: Chaos (Verification)
Verification involves `M-x benchmark-init` and ensuring zero warnings during the byte-compilation phase.