add: CLI smos; modify: usage introduction; fix: docs formatting;

Author: ltndat

README.md

@@ -1,4 +1,4 @@
-# Track Template by Second Mind OS (SMOS)
+# Track Template Protocol by Second Mind OS (SMOS)
 
 > Track your thinking. Loop your learning. Build public artifacts. Powered by SMOS.
 
@@ -41,14 +41,16 @@ This is the **official template** for constructing trackable learning systems fr
 
 ```mermaid
 graph TD
-  A[Engage with Content] --> B[Build Project / Problem]
+  A[Engage with Content] --> B[Note Docs / Build Project / Problem]
   B --> C[P.A.C.E.R. Loop]
   C --> D[Write Logs + Loop Claim]
   D --> E[Claim ⌬ Symbol]
   E --> F[Public Output in outputs/]
   F --> G[Emit JSON to Personal Site]
 ```
 
+> Note → Log → Loop → Output
+
 ### 🔁 P.A.C.E.R. Loop Protocol
 
 Each learning unit runs through the **P.A.C.E.R. loop** — a minimal feedback protocol for deliberate skill formation:
@@ -72,20 +74,22 @@ Each folder in `loop/Week-X/` should contain a `pacer.yaml` or markdown journal
    → Serve `outputs/` as public-facing artifacts
 
 3. **Loop Structure**
-
+   - New loop via CLI (Recommend) `python scripts/smos.py week-01 --topic="Memory & Pointers"`
    - Drop notes into `docs/`
-   - Launch a loop via `loop/week-01/pacer.yaml`
-   - Push deliverables to `outputs/`
    - Write blockers / insight logs in `logs/`
+   - Launch a loop via `loop/week-01/pacer.yaml`, `loop/week-01/claim.md`, `loop/week-01/reflect.md`
+   - Push deliverables to `outputs/`
 
 #### Example:
 
 ```bash
 track-cs50x/
 ├── docs/week-01.md                  # Schema of memory model
+├── logs/YYYY-MM-DD-week-01.md       # Blocker resolution
 ├── loop/week-01/pacer.yaml          # P.A.C.E.R. config
-├── outputs/pset1-mario.md           # Artifact: reflection + code
-├── logs/2025-05-16-pointer-log.md   # Blocker resolution
+├── loop/week-01/claim.md            # Distilled knowledge lock
+├── loop/week-01/reflect.md          # Meta-log & feedback
+├── outputs/week-01-output.md        # Artifact: reflection + code
 ```
 
 #### Naming Convention (Optional):

docs/week-01.md

@@ -1,17 +1,17 @@
-# Week 01 — [Insert Topic Title Here]
+# Week 01 — [Topic]
 
 > Track: [track-name]  
 > Week: 01  
 > Protocol: Second Mind OS  
 > Format: Verified Thinking Notes + Schema-Driven Capture
 
-## OBJECTIVE
+## Objective
 
 - **Core Concept(s)**: What is being learned this week?
 - **Outcome**: What am I expected to produce or understand?
 - **Protocol Scope**: This note follows the PACER loop → it serves as a **Check + Reflect** anchor.
 
-## CONCEPT MAP / SCHEMA
+## Concept Map / Schema
 
 > Use this section to describe the concept using:
 
@@ -26,14 +26,14 @@ graph TD
   A --> D[Subcomponent 2]
 ```
 
-## MENTAL MODELS
+## Mental Models
 
 | Concept         | Model / Metaphor                   | First-principle Breakdown         |
 | --------------- | ---------------------------------- | --------------------------------- |
 | \[e.g. Pointer] | "Memory arrow → points to a box"   | Address vs. value distinction     |
 | \[e.g. Stack]   | Stack = vertical tray, LIFO system | Memory ordering via frame context |
 
-## ⌬ INSIGHT CLAIMS
+## 📣 ⌬ Insight Claims
 
 List insights that are **non-obvious**, and **must be claimed explicitly**, not just mentioned.
 
@@ -42,33 +42,35 @@ List insights that are **non-obvious**, and **must be claimed explicitly**, not
 | 001  | "A pointer holds an address, not the value"  | Lecture Q\&A  | `logs/2025-05-16-log.md`  |
 | 002  | "Refactoring reveals abstraction boundaries" | During pset   | `loop/week-01/pacer.yaml` |
 
-## 🚧 BLOCKERS / AMBIGUITIES
+## 🚧 Blockers / Ambiguities
 
 > List anything unclear, buggy, unresolved. These can be escalated into logs.
 
 - Why is stack memory auto-freed, but heap not?
 - Pointer vs reference distinction in C vs Rust?
 
-## 🧪 TESTS / SELF-CHECKS
+## 🧪 Tests / Self-Checks
 
 > Add one or more test questions to check understanding
 
 1. Draw memory diagram of `int *p = &x;`, label addresses and values
 2. When does segmentation fault occur when using pointers?
 
-## 📃 TRACE LOG / LEARNING PATH
+## 📃 Trace Log / Learning Path
 
 - [x] Watched Lecture 1
 - [x] Read `Pointers in C` (CS50 Notes)
 - [x] Completed `pset1-Mario`
 - [ ] Created public output reflection
 - [ ] Shared ⌬ card with claim `001`
 
-## 🔁 LINKED PROTOCOL LOOPS
+## 🔁 Linked Protocol Loops
 
-| Loop Phase | Linked File                      |
-| ---------- | -------------------------------- |
-| Plan       | `loop/week-01/pacer.yaml`        |
-| Reflect    | `logs/2025-05-16-pointer-log.md` |
+| Loop Phase | Linked File                  |
+| ---------- | ---------------------------- |
+| Plan       | `loop/week-01/pacer.yaml`    |
+| Reflect    | `logs/YYYY-MM-DD-week-01.md` |
+
+---
 
 > _Powered by [**Second Mind OS Lab**](https://github.com/secondmindlab) — Protocol-first learning system for cognitive leverage._

logs/YYYY-MM-DD-week-01.md

@@ -10,7 +10,7 @@
 
 - `docs/week-01.md`
 - `loop/week-01/pacer.yaml`
-- `outputs/pset1-mario.md`
+- `outputs/week-01-output.md`
 
 ## 2. 🚧 Blockers / Bugs / Blindspots
 
@@ -41,7 +41,7 @@
 
 ## 6. Next Steps
 
-- Update `outputs/pset1-mario.md` with fixed version + ⌬ claims
+- Update `outputs/week-01-output.md` with fixed version + ⌬ claims
 - Start new PACER loop for Week-02
 - Share selected insight card to LinkedIn ("⌬ Debug = trace > theory")
 

loop/week-01/claim.md

@@ -1,24 +1,26 @@
-# ⌬ Claim — Week 01
+# ⌬ Claim — Week 01: [Topic]
 
 ## 📣 Claim
 
-- **Fact Lock-in**: (kiến thức đúng)  
+- **Fact Lock-in**: (knowledge)  
   Eg: “I understand the difference between stack and heap memory.”
 
-- **Skill Capability**: (có thể hành động được)  
+- **Skill Capability**: (actionable)  
   Eg: “I can debug null-pointer segfaults in C using `valgrind` and logical tracing.”
 
-- **Insight Shift**: (mindset / abstraction layer nâng cấp)  
+- **Insight Shift**: (mindset / abstraction layer upgrade)  
   Eg: “Pointers are not just addresses — they represent indirection, which generalizes to references in high-level langs.”
 
 ## Evidence
 
-- Verified via: [`logs/2025-05-18-pointer-log.md`](../../logs/2025-05-18-pointer-log.md)
-- Output artifact: [`outputs/pset1-mario.md`](../../outputs/pset1-mario.md)
+- Verified via: [`logs/YYYY-MM-DD-week-01.md`](../../logs/YYYY-MM-DD-week-01.md)
+- Output artifact: [`outputs/week-01-output.md`](../../outputs/week-01-output.md)
 - Source of knowledge: CS50x Lectures + Pset1
 
 ## Note
 
 This ⌬ **Mindstamp** represents a crystallized loop outcome.
 
-> Powered by **Second Mind OS**
+---
+
+> _Powered by Second Mind OS_

loop/week-01/reflect.md

@@ -1,4 +1,4 @@
-# 🪞 Reflect — Week 01
+# Reflect — Week 01: [Topic]
 
 ## What clicked?
 
@@ -12,7 +12,7 @@
 
 - <What would your 3-days-ago self do better now?>
 
-## Meta-level feedback
+## 🏛 Meta-level feedback
 
 - Protocol friction: <Was PACER too heavy or helpful?>
 - System effectiveness: <Did the loop create clarity or chaos?>
@@ -25,3 +25,7 @@
 ## Quote
 
 > "Insert a quote or reflection sentence that encapsulates this week."
+
+---
+
+> _Powered by Second Mind OS_

outputs/week-01.md outputs/week-01-output.mdoutputs/week-01.md renamed to outputs/week-01-output.md

@@ -1,4 +1,4 @@
-# Output — Week 01
+# Output — Week 01: [Topic]
 
 ## Task
 
@@ -68,16 +68,17 @@ Brief description — what did you make / produce?
 - ⌬ Claim: `Memory tracing = 4-layer address mental model`
 - Situation: `While debugging segfault`
 - Impact: `Accelerated understanding of stack/heap`
-- Verified: [`logs/2025-05-16-pointer-log.md`](../logs/2025-05-16-pointer-log.md)
+- Verified: [`logs/YYYY-MM-DD-week-01.md`](../logs/YYYY-MM-DD-week-01.md)
 
 ---
 
 ## References
 
 - Links to doc, forums, other outputs
 
-> 📏 **Protocol Tag**: `Verified: logs/2025-05-xx-pointer-log.md`
->
+> 📏 **Protocol Tag**: `Verified: logs/YYYY-MM-DD-week-01.md`  
 > 📣 ⌬ Claim Origin: `"Pointer tracing = mental model of memory layers"`
->
+
+---
+
 > _Powered by Second Mind OS_

scripts/smos.py

@@ -5,70 +5,53 @@
 import argparse
 from datetime import datetime
 
-TEMPLATE_PACER = """loop_id: {loop_id}
-topic: {topic}
-plan:
-  - TODO: Define objective
-  - TODO: Define scope
-  - TODO: Define constraints
-outputs:
-  - outputs/{loop_id}-output.md
-logs:
-  - logs/{today}-{loop_id}-log.md
-status: in-progress
-claims:
-  - ⌬ TODO: Write symbolic claim
-"""
+TEMPLATE_PACER = """loop_id: {loop_id}"""
 
-TEMPLATE_NOTE = """# {loop_id} — {topic}
+TEMPLATE_CLAIM = """# ⌬ Claim — {loop_id}: {topic}
+
+---
+
+> _Powered by **Second Mind OS**._
+
+"""
 
-## Concepts
-- 
+TEMPLATE_REFLECT = """# Reflect — {loop_id}: {topic}
 
-## Code examples
-- 
+---
 
-## Insight
-- 
+> _Powered by **Second Mind OS**._
 
-## Questions
-- 
 """
 
-TEMPLATE_LOG = """# Log — {today}
+TEMPLATE_NOTE = """# {loop_id} — {topic}
 
-## Blockers 🚧
-- 
+---
 
-## Resolutions 🛠️
-- 
+> _Powered by [**Second Mind OS Lab**](https://github.com/secondmindlab) — Protocol-first learning system for cognitive leverage._
 
-## Pings 💡
-- 
 """
 
-TEMPLATE_OUTPUT = """# Output — {loop_id}
+TEMPLATE_LOG = """# Log — {today}
 
-## Summary
+---
 
-## Final Code
+**Powered by Second Mind OS** — _Log-traceable insight loops for deep learning._
 
-## Reflection
+"""
 
-## Link
+TEMPLATE_OUTPUT = """# Output — {loop_id}: {topic}
 
-Verified: logs/{today}-{loop_id}-log.md
+---
 
-⌬ Mindstamp: TODO
+> _Powered by Second Mind OS_
 
-Powered by Second Mind OS
 """
 
 
 def create_file(path, content):
     with open(path, "w") as f:
         f.write(content)
-    print(f"✅ Created: {path}")
+    print(f"- {path}")
 
 
 def init_loop(loop_id, topic):
@@ -79,20 +62,28 @@ def init_loop(loop_id, topic):
     os.makedirs("logs", exist_ok=True)
     os.makedirs("outputs", exist_ok=True)
 
+    create_file(
+        f"docs/{loop_id}.md",
+        TEMPLATE_NOTE.format(loop_id=loop_id, topic=topic),
+    )
+    create_file(
+        f"logs/{today}-{loop_id}-log.md", TEMPLATE_LOG.format(today=today)
+    )
     create_file(
         f"loop/{loop_id}/pacer.yaml",
         TEMPLATE_PACER.format(loop_id=loop_id, topic=topic, today=today),
     )
     create_file(
-        f"docs/{loop_id}.md",
-        TEMPLATE_NOTE.format(loop_id=loop_id, topic=topic),
+        f"loop/{loop_id}/claim.md",
+        TEMPLATE_CLAIM.format(loop_id=loop_id, topic=topic),
     )
     create_file(
-        f"logs/{today}-{loop_id}-log.md", TEMPLATE_LOG.format(today=today)
+        f"loop/{loop_id}/reflect.md",
+        TEMPLATE_REFLECT.format(loop_id=loop_id, topic=topic),
     )
     create_file(
         f"outputs/{loop_id}-output.md",
-        TEMPLATE_OUTPUT.format(loop_id=loop_id, today=today),
+        TEMPLATE_OUTPUT.format(loop_id=loop_id, topic=topic, today=today),
     )