From e094f2c287bf46cfa3f552a58ebcf7c894ce5dd6 Mon Sep 17 00:00:00 2001 From: Eduardo Borjas Date: Sat, 6 Jun 2026 16:25:48 -0600 Subject: [PATCH 1/2] feat: add SOP architecture layer (type: sop) + fix template frontmatter validation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Introduce Standard Operating Procedures (SOPs) as a first-class CKIS artifact type — executable, repeatable, step-by-step procedures, distinct from permanent notes (compounding knowledge) and workflows (multi-file operating systems). Added: - 00-systems/sops/_convention.md — canonical SOP convention (type: sop standard, body template, two-tier home rule, domains, how-to-add). - 00-systems/sops/_index.md — global SOP registry (template, with example rows). - 08-templates/sop.md — SOP template. - 00-systems/_convention.md — systems-folder convention (was missing here). Wired into the spec/governance: SCHEMA.md + 02/08 frontmatter enums gain `sop`; file 08 gets an SOP template section; file 13 gets a "New SOP" trigger + procedure; file 00 gets an SOP operating mode. Also fixes a pre-existing CI bug: scripts/validate-frontmatter.py now skips 08-templates/, whose files are Obsidian template molds containing {{date}} / {{title}} placeholders that are valid Templater syntax but not valid YAML. Co-Authored-By: Claude Opus 4.8 --- 00-systems/_convention.md | 46 ++++++ 00-systems/ckis/00-ckis-master-context.md | 3 +- .../ckis/02-obsidian-vault-architecture.md | 14 +- .../ckis/08-note-templates-and-frontmatter.md | 39 ++++- .../13-maintenance-and-update-protocol.md | 12 +- 00-systems/sops/_convention.md | 144 ++++++++++++++++++ 00-systems/sops/_index.md | 53 +++++++ 08-templates/_convention.md | 3 +- 08-templates/sop.md | 66 ++++++++ SCHEMA.md | 2 +- scripts/validate-frontmatter.py | 4 +- 11 files changed, 372 insertions(+), 14 deletions(-) create mode 100644 00-systems/_convention.md create mode 100644 00-systems/sops/_convention.md create mode 100644 00-systems/sops/_index.md create mode 100644 08-templates/sop.md diff --git a/00-systems/_convention.md b/00-systems/_convention.md new file mode 100644 index 0000000..c5178d2 --- /dev/null +++ b/00-systems/_convention.md @@ -0,0 +1,46 @@ +--- +type: system +subtype: convention +folder: 00-systems +created: 2026-05-24 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +related: + - "[[00-systems/ckis/02-obsidian-vault-architecture]]" +canonical: true +--- + +# Convention — 00-systems/ + +## Purpose +Vault infrastructure — the systems that make the Second Brain function. This is not knowledge content; it is the architecture and operational protocols of CKIS. Only [OWNER] and their agents need to read this; it is not oriented toward day-to-day consultable content. + +## Internal Structure + +``` +00-systems/ +├── ckis/ → CKIS architecture: rules, templates, protocols, memory +├── workflows/ → Reusable CKIS workflows (with _index.md) +├── tools/ → Reusable tools: prompts, scripts, configs +└── sops/ → SOPs: executable, repeatable procedures (_index.md + _convention.md) +``` + +## What Goes Here +- System architecture and rules files (CKIS) +- Reusable operational workflows +- Support tools (production prompts, maintenance scripts) +- Cross-cutting SOPs — executable, repeatable procedures that span multiple projects or govern CKIS itself + +## What Does NOT Go Here +- Knowledge notes → `03-knowledge/` +- Active projects → `02-projects/` +- Agent skills → `~/.claude/skills/` (outside the vault) or `.claude/ckis-skills/` (vault-local) + +## Modification Rule +Files in `00-systems/ckis/` are high-consequence — read the CHANGELOG before editing. For non-trivial changes, make a backup in `.claude/backups/` and log the change in `00-systems/ckis/CHANGELOG.md`. + +## Related Folders +- [[00-systems/ckis/_CONVENTION]] — CKIS folder convention +- [[00-systems/tools/_convention]] — reusable tools +- [[00-systems/workflows/_index.md]] — workflows index (companion _convention at root folder) diff --git a/00-systems/ckis/00-ckis-master-context.md b/00-systems/ckis/00-ckis-master-context.md index 8f34c3c..8a8fbb4 100644 --- a/00-systems/ckis/00-ckis-master-context.md +++ b/00-systems/ckis/00-ckis-master-context.md @@ -1,7 +1,7 @@ --- type: system created: 2026-05-02 -modified: 2026-05-04 +modified: 2026-06-06 tags: [ckis, system, master-context] status: active related: ["[[01-ckis-user-profile-and-operating-context]]", "[[02-obsidian-vault-architecture]]"] @@ -123,6 +123,7 @@ The CKIS vault is the **canonical source of truth** for strategic knowledge. Eve - **Decision mode** — decision logs (see `06-decision-execution-and-review-protocol.md`). - **Review mode** — daily brief, weekly review, monthly consolidation. - **Maintenance mode** — `sync overviews`, archive, template updates (see `13-maintenance-and-update-protocol.md`). +- **SOP mode** — capture executable, repeatable procedures as first-class `type: sop` SOPs under `00-systems/sops/` (cross-cutting) or a project's `processes/` (project-specific). Registry: [[00-systems/sops/_index]]; convention: [[00-systems/sops/_convention]]. ## 8. Confirmed Facts diff --git a/00-systems/ckis/02-obsidian-vault-architecture.md b/00-systems/ckis/02-obsidian-vault-architecture.md index da23c3c..b7f3b0b 100644 --- a/00-systems/ckis/02-obsidian-vault-architecture.md +++ b/00-systems/ckis/02-obsidian-vault-architecture.md @@ -1,7 +1,7 @@ --- type: system created: 2026-05-02 -modified: 2026-05-13 +modified: 2026-06-06 tags: [ckis, vault, architecture] status: active related: ["[[00-ckis-master-context]]", "[[07-projects-areas-resources-archives-map]]", "[[08-note-templates-and-frontmatter]]"] @@ -74,10 +74,11 @@ related: ["[[00-ckis-master-context]]", "[[07-projects-areas-resources-archives- │ └── client-note.md ├── 09-archive/ # Completed or inactive ├── 00-system/ # CKIS system files (this folder) -│ └── CKIS/ -│ ├── 00-ckis-master-context.md -│ ├── 01-ckis-user-profile-and-operating-context.md -│ └── ... +│ ├── CKIS/ +│ │ ├── 00-ckis-master-context.md +│ │ ├── 01-ckis-user-profile-and-operating-context.md +│ │ └── ... +│ └── sops/ # SOPs — executable, repeatable procedures (_index.md + _convention.md) ├── .claude/ │ ├── CLAUDE.md # Master instructions + command shortcuts │ ├── ckis-skills/ # Vault-specific CKIS workflow skills (25 skills) @@ -120,7 +121,7 @@ Every note has YAML frontmatter: ```yaml --- -type: [permanent-note | literature-note | project | daily | resource | capture | area | goal | person | system] +type: [permanent-note | literature-note | project | daily | resource | capture | area | goal | person | system | sop] created: YYYY-MM-DD modified: YYYY-MM-DD tags: [] @@ -164,6 +165,7 @@ Notes: | `goal` | `06-goals/` | Annual / monthly / weekly goal notes | | `person` | `07-people//` | Relationship notes | | `system` | `00-system/ckis/` | CKIS architecture and operating rules | +| `sop` | `00-systems/sops/` or `/processes/` | Executable, repeatable step-by-step procedure (SOP) | ## 9. Dashboards & Indexes diff --git a/00-systems/ckis/08-note-templates-and-frontmatter.md b/00-systems/ckis/08-note-templates-and-frontmatter.md index 81a179c..a2d0e88 100644 --- a/00-systems/ckis/08-note-templates-and-frontmatter.md +++ b/00-systems/ckis/08-note-templates-and-frontmatter.md @@ -1,7 +1,7 @@ --- type: system created: 2026-05-02 -modified: 2026-05-28 +modified: 2026-06-06 tags: [ckis, templates, frontmatter] status: active related: ["[[02-obsidian-vault-architecture]]", "[[04-claude-code-obsidian-agent]]"] @@ -17,7 +17,7 @@ related: ["[[02-obsidian-vault-architecture]]", "[[04-claude-code-obsidian-agent ```yaml --- -type: [permanent-note | literature-note | project | archive-note | daily | resource | capture | area | goal | person | system] +type: [permanent-note | literature-note | project | archive-note | daily | resource | capture | area | goal | person | system | sop] created: YYYY-MM-DD modified: YYYY-MM-DD tags: [] @@ -29,7 +29,7 @@ related: [] Field rules: -- `type` — required; one of the enum. +- `type` — required; one of the enum. `sop` for Standard Operating Procedures (see §14). - `created` — required; never overwrite. - `modified` — required; should equal the latest git commit date (`git log` is authoritative, not filesystem `mtime`). - `tags` — kebab-case strings without leading `#`. @@ -367,3 +367,36 @@ related: [] ``` Used for files in `00-system/ckis/`. Keeps tone and structure consistent across the system folder. + +## 14. SOP Template + +For Standard Operating Procedures in `00-systems/sops/` or `/processes/`. Canonical convention: [[00-systems/sops/_convention]]. + +```yaml +--- +type: sop +created: YYYY-MM-DD +modified: YYYY-MM-DD +tags: [sop, , ...] +status: active # active | draft | deprecated +sop_domain: # ckis | dev | os-hardware | [your-project] | content ... +trigger: "" # invocation phrase if agent-invokable, else empty +related: [] +--- +``` + +```markdown +# SOP — +> One-line purpose · who runs this · when. + +## 1. Purpose & Scope +## 2. When to Execute +## 3. Prerequisites +## 4. Steps +## 5. Verification / Expected Output +## 6. Troubleshooting (optional — symptom | cause | fix table) +## 7. Notes & Exceptions / Lessons Learned (optional) +## 8. Agent-Delegatable Summary (optional — paste block to hand an agent) + +*SOP v — — * +``` diff --git a/00-systems/ckis/13-maintenance-and-update-protocol.md b/00-systems/ckis/13-maintenance-and-update-protocol.md index bb4639e..0c79172 100644 --- a/00-systems/ckis/13-maintenance-and-update-protocol.md +++ b/00-systems/ckis/13-maintenance-and-update-protocol.md @@ -1,7 +1,7 @@ --- type: system created: 2026-05-02 -modified: 2026-05-02 +modified: 2026-06-06 tags: [ckis, maintenance, updates] status: active related: ["[[00-ckis-master-context]]", "[[09-cross-model-shared-context-protocol]]"] @@ -25,6 +25,7 @@ related: ["[[00-ckis-master-context]]", "[[09-cross-model-shared-context-protoco | CKIS architecture change | the relevant `00-system/ckis/.md`, `CHANGELOG.md`, ChatGPT upload package | | New decision protocol | `[[06-decision-execution-and-review-protocol]]` | | Frontmatter / template change | `[[02-obsidian-vault-architecture]]` §5, `[[08-note-templates-and-frontmatter]]` | +| New SOP | create in correct tier, fill from `[[08-templates/sop]]`, register in `[[00-systems/sops/_index]]`, CHANGELOG if cross-cutting | ## 2. Adding a New Project @@ -35,6 +36,15 @@ related: ["[[00-ckis-master-context]]", "[[09-cross-model-shared-context-protoco 5. If a project repository exists at `~//`, plan the project-level `CLAUDE.md` bridge (open question — see `[[00-ckis-master-context]]` §9 #3). 6. First commit: `feat: add project`. +## 2b. Adding a New SOP + +1. Decide tier — project-specific → `02-projects//processes/`; cross-cutting/system/personal → `00-systems/sops//`. +2. Copy `[[08-templates/sop]]`. +3. Fill §1–5 (required). +4. Add a row to `[[00-systems/sops/_index]]`. +5. CHANGELOG entry if cross-cutting/system-level. +6. First commit: `feat(sop): add SOP`. + ## 3. Updating Context Files System files in `00-inbox/` (`_PROFILE.md`, `_INTERESTS.md`, `_ACTIVE-PROJECTS.md`, `_MEMORY.md`): diff --git a/00-systems/sops/_convention.md b/00-systems/sops/_convention.md new file mode 100644 index 0000000..871d2d2 --- /dev/null +++ b/00-systems/sops/_convention.md @@ -0,0 +1,144 @@ +--- +type: system +subtype: convention +folder: 00-systems/sops +created: 2026-06-06 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis, sop] +related: + - "[[00-systems/ckis/02-obsidian-vault-architecture]]" + - "[[00-systems/ckis/08-note-templates-and-frontmatter]]" + - "[[00-systems/_convention]]" +canonical: true +--- + +# Convention — 00-systems/sops/ + +## Purpose + +An **SOP (Standard Operating Procedure)** is an executable, repeatable, step-by-step procedure for accomplishing a specific operational task. You run an SOP; you do not just read it. + +**SOP vs permanent note vs workflow:** + +| Artifact | Lives in | What it is | How you use it | +|----------|----------|------------|----------------| +| **SOP** | `00-systems/sops//` or `/processes/` | Executable step-by-step procedure | You run it start-to-finish | +| **Permanent note** | `03-knowledge/` | Compounding knowledge — insight, concept, framework | You read, reference, and build on it | +| **Workflow** | `00-systems/workflows/` | Large multi-file operating system for a work domain | You activate and maintain it long-term | + +This file is the convention companion to `_index.md`. The `_index.md` is the registry of every active SOP; this `_convention.md` defines what can live here and how. + +━━━ + +## What Goes Here + +- Cross-cutting SOPs that apply to CKIS, development, OS/hardware, or content — not specific to one project +- Subdomain folders: `ckis/`, `dev/`, `os-and-hardware/`, `content/` +- The root `_index.md` that registers every SOP (both tiers) + +## What Does NOT Go Here + +- Project-specific SOPs → stay in `02-projects//processes/` +- Conceptual frameworks → `03-knowledge/frameworks/` +- Generic knowledge guides → `03-knowledge/guides/` +- Agent skills (Claude Code) → `~/.claude/skills/` or `.claude/ckis-skills/` +- Source code or scripts → external code repository + +━━━ + +## Two-Tier Home Rule + +``` +Tier 1 — Project-local: 02-projects//processes/ + For SOPs tightly coupled to one project's operations. + Owned by that project's team/context. + +Tier 2 — Cross-cutting: 00-systems/sops// + For SOPs that span projects, apply to CKIS itself, + or govern [OWNER]'s personal operating system. + +BOTH tiers are registered in [[00-systems/sops/_index]]. +``` + +━━━ + +## File Naming Convention + +- `-sop.md` suffix for all SOP files +- Descriptive kebab-case prefix for the process name +- Examples: + - `inbox-processing-sop.md` + - `weekly-review-sop.md` + - `client-site-deploy-sop.md` + - `api-key-rotation-sop.md` + - `pop-os-fresh-install-sop.md` + +━━━ + +## Required Frontmatter + +```yaml +--- +type: sop +created: YYYY-MM-DD +modified: YYYY-MM-DD +tags: [sop, , ...] +status: active # active | draft | deprecated +sop_domain: # ckis | dev | os-hardware | [your-project] | content ... +trigger: "" # invocation phrase if agent-invokable, else empty +related: [] +--- +``` + +━━━ + +## Body Template + +```markdown +# SOP — +> One-line purpose · who runs this · when. + +## 1. Purpose & Scope +## 2. When to Execute +## 3. Prerequisites +## 4. Steps +## 5. Verification / Expected Output +## 6. Troubleshooting (optional — symptom | cause | fix table) +## 7. Notes & Exceptions / Lessons Learned (optional) +## 8. Agent-Delegatable Summary (optional — paste block to hand an agent) + +*SOP v — — * +``` + +Sections §1–5 are **required**. Sections §6–8 are optional but encouraged for complex or agent-invokable SOPs. + +━━━ + +## Domains + +| Domain | Lives in | Examples | +|--------|----------|---------| +| `ckis` | `00-systems/sops/ckis/` | Inbox processing, weekly review, CKIS maintenance | +| `dev` | `00-systems/sops/dev/` | Repo bootstrap, deployment runbooks, API key rotation | +| `os-hardware` | `00-systems/sops/os-and-hardware/` | Pop!_OS install, USB boot, hardware setup | +| `content` | `00-systems/sops/content/` | YouTube upload, social post, newsletter send | +| `project-local` | `/processes/` | [YOUR_PROJECT] client onboarding, [YOUR_CLIENT] deploy | + +━━━ + +## How to Add a New SOP + +1. **Pick tier** — project-local (`/processes/`) or cross-cutting (`00-systems/sops//`). +2. **Copy template** — duplicate `[[08-templates/sop]]` into the target folder. +3. **Fill §1–5** — at minimum, complete Purpose, When to Execute, Prerequisites, Steps, and Verification. +4. **Register** — add a row to `[[00-systems/sops/_index]]` under the correct domain subheading. +5. **CHANGELOG** — if the SOP is cross-cutting or modifies CKIS, add an entry to `[[00-systems/ckis/CHANGELOG]]`. + +━━━ + +## Related Folders + +- [[00-systems/workflows/_convention]] — workflows (large multi-file operating systems) +- `/processes/_convention.md` — project-local SOP convention (generalised by this file) +- [[08-templates/_convention]] — Obsidian templates (includes `sop.md` template) diff --git a/00-systems/sops/_index.md b/00-systems/sops/_index.md new file mode 100644 index 0000000..aa2e06e --- /dev/null +++ b/00-systems/sops/_index.md @@ -0,0 +1,53 @@ +--- +type: system +subtype: sops-index +created: 2026-06-06 +modified: 2026-06-06 +status: active +tags: [sop, systems, ckis, index] +related: + - "[[00-systems/ckis/00-ckis-master-context]]" + - "[[00-systems/sops/_convention]]" +canonical: true +--- + +# CKIS SOP Index + +## What is an SOP in CKIS? + +A Standard Operating Procedure (SOP) is an executable, repeatable, step-by-step procedure for accomplishing a specific operational task. See [[00-systems/sops/_convention]] for the full convention — what qualifies as an SOP, the two-tier home rule, file naming, required frontmatter, and how to add a new SOP. + +## SOP Registry + +_Register every SOP here at creation time. Example rows below — replace with your own._ + +### ckis + +| SOP | Location | Trigger | Status | +|-----|----------|---------|--------| +| `inbox-processing-sop` | `00-systems/sops/ckis/` | — | active | + +### dev + +| SOP | Location | Trigger | Status | +|-----|----------|---------|--------| + +### content + +| SOP | Location | Trigger | Status | +|-----|----------|---------|--------| + +### os-hardware + +| SOP | Location | Trigger | Status | +|-----|----------|---------|--------| + +### project-local + +| SOP | Location | Trigger | Status | +|-----|----------|---------|--------| +| `client-onboarding-sop` | `[your-project]/processes/` | — | active | + +## How this index is maintained + +See [[00-systems/ckis/13-maintenance-and-update-protocol]] §2b — every new SOP gets a row here at creation time. Cross-cutting SOPs also get a CHANGELOG entry. diff --git a/08-templates/_convention.md b/08-templates/_convention.md index 6aed9d1..80ce72c 100644 --- a/08-templates/_convention.md +++ b/08-templates/_convention.md @@ -3,7 +3,7 @@ type: system subtype: convention folder: 08-templates created: 2026-05-24 -modified: 2026-05-24 +modified: 2026-06-06 status: active tags: [convention, systems, ckis] related: @@ -37,6 +37,7 @@ Obsidian templates — base files with predefined structure for creating new not | `daily.md` | Daily notes in `01-daily/` | | `client-note.md` | Client notes in `07-people/clients/` | | `monthly.md` | Monthly reports in `06-goals/monthly/` | +| `sop.md` | SOPs in `00-systems/sops/` or `/processes/` | ## Rule If a new template is created here, also add its spec to [[00-systems/ckis/08-note-templates-and-frontmatter]]. diff --git a/08-templates/sop.md b/08-templates/sop.md new file mode 100644 index 0000000..43902ca --- /dev/null +++ b/08-templates/sop.md @@ -0,0 +1,66 @@ +--- +type: sop +created: {{date:YYYY-MM-DD}} +modified: {{date:YYYY-MM-DD}} +tags: [sop] +status: draft +sop_domain: "" +trigger: "" +related: [] +--- + +# SOP — +> One-line purpose · who runs this · when. + +## 1. Purpose & Scope + +_What problem does this SOP solve? What is in scope and what is explicitly out of scope?_ + +## 2. When to Execute + +_Trigger conditions: event-driven ("when X happens"), time-based ("every Monday"), or on-demand ("before any client demo")._ + +## 3. Prerequisites + +_Tools, credentials, files, or states that must be in place before step 1. Use a checklist._ + +- [ ] + +## 4. Steps + +_Numbered. Each step has the exact command/code in a code block._ + +1. +2. +3. + +## 5. Verification / Expected Output + +_How do you know it worked? What should you see, hear, or be able to confirm at the end?_ + +## 6. Troubleshooting + +_Optional — use when failure modes are known._ + +| Symptom | Likely Cause | Fix | +|---------|-------------|-----| +| | | | + +## 7. Notes & Exceptions / Lessons Learned + +_Optional — edge cases, gotchas, historical context, or lessons from past runs._ + +## 8. Agent-Delegatable Summary + +_Optional — paste this block verbatim to hand an agent a self-contained task description._ + +``` +Goal: +Context: +Steps: +Success criteria: +``` + +━━━ + +*SOP v1.0 — — * diff --git a/SCHEMA.md b/SCHEMA.md index 8e65bed..d956468 100644 --- a/SCHEMA.md +++ b/SCHEMA.md @@ -53,7 +53,7 @@ Every note requires YAML frontmatter: ```yaml --- -type: +type: created: YYYY-MM-DD modified: YYYY-MM-DD tags: [tag-one, tag-two] diff --git a/scripts/validate-frontmatter.py b/scripts/validate-frontmatter.py index a4ea828..08dbccb 100644 --- a/scripts/validate-frontmatter.py +++ b/scripts/validate-frontmatter.py @@ -6,7 +6,9 @@ from pathlib import Path import yaml -SKIP_DIRS = {'.git', '.obsidian', 'node_modules'} +# 08-templates/ holds template "molds" with {{date}} / {{title}} placeholders +# that are valid Obsidian Templater syntax but not valid YAML — skip them. +SKIP_DIRS = {'.git', '.obsidian', 'node_modules', '08-templates'} REQUIRED_FIELDS = {'type', 'created', 'modified'} EXEMPT_FILES = {'README.md', 'CHANGELOG.md', 'CONTRIBUTING.md', 'SECURITY.md', 'CODE_OF_CONDUCT.md', 'SCHEMA.md', 'CLAUDE.md'} From c96cd6e2e35b118246c2a9a8bbb2b4105cc69e16 Mon Sep 17 00:00:00 2001 From: Eduardo Borjas Date: Sat, 6 Jun 2026 19:15:11 -0600 Subject: [PATCH 2/2] =?UTF-8?q?ci:=20repair=20pre-existing=20CI=20?= =?UTF-8?q?=E2=80=94=20CONVENTION.md=20frontmatter=20+=20secret-scan=20reg?= =?UTF-8?q?ex?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add YAML frontmatter (type: system / subtype: convention) to 9 per-directory CONVENTION.md files so the frontmatter validator passes. - Tighten secret-scan to match real key shapes (sk-ant-, etc.) instead of bare prefixes / the ANTHROPIC_API_KEY var name — removes false positives on documentation placeholders while still catching genuine keys. Co-Authored-By: Claude Opus 4.8 --- .github/workflows/ci.yml | 2 +- 00-inbox/CONVENTION.md | 10 ++++++++++ 00-systems/workflows/CONVENTION.md | 10 ++++++++++ 02-projects/CONVENTION.md | 10 ++++++++++ 03-knowledge/CONVENTION.md | 10 ++++++++++ 04-resources/CONVENTION.md | 10 ++++++++++ 04-resources/social-captures/CONVENTION.md | 10 ++++++++++ 05-areas/CONVENTION.md | 10 ++++++++++ 06-goals/CONVENTION.md | 10 ++++++++++ 07-people/CONVENTION.md | 10 ++++++++++ 10 files changed, 91 insertions(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index c7244cb..eb77652 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -52,7 +52,7 @@ jobs: - name: Check for accidentally committed secrets run: | # Basic check for common secret patterns - if grep -rE "(ANTHROPIC_API_KEY|sk-ant-|sk-proj-|ghp_|gho_)" \ + if grep -rE "(sk-ant-[A-Za-z0-9_-]{16,}|sk-proj-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|gho_[A-Za-z0-9]{20,})" \ --include="*.md" --include="*.json" --include="*.sh" \ --exclude-dir=".git" . 2>/dev/null | grep -v "example\|placeholder\|YOUR_KEY"; then echo "Potential secret found in committed files. Review above matches." diff --git a/00-inbox/CONVENTION.md b/00-inbox/CONVENTION.md index 0417acb..ea55da0 100644 --- a/00-inbox/CONVENTION.md +++ b/00-inbox/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 00-inbox +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 00-inbox — Capture Zone **Purpose:** Everything enters the vault here first. Never organize in the moment — capture now, process later. diff --git a/00-systems/workflows/CONVENTION.md b/00-systems/workflows/CONVENTION.md index 087d6ed..ea9c3e2 100644 --- a/00-systems/workflows/CONVENTION.md +++ b/00-systems/workflows/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 00-systems/workflows +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 00-systems/workflows — Automated Workflows **Purpose:** Reusable, documented workflows — processes you've automated or structured as repeatable prompts. diff --git a/02-projects/CONVENTION.md b/02-projects/CONVENTION.md index 4bc7e3c..7b6ad8e 100644 --- a/02-projects/CONVENTION.md +++ b/02-projects/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 02-projects +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 02-projects — Active Projects **Purpose:** One folder per active project. Each folder is self-contained: overview, clients, processes, and a link to the Dev Brain code index. diff --git a/03-knowledge/CONVENTION.md b/03-knowledge/CONVENTION.md index 2977f1d..a7d9676 100644 --- a/03-knowledge/CONVENTION.md +++ b/03-knowledge/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 03-knowledge +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 03-knowledge — Processed Knowledge **Purpose:** Where raw captures become durable knowledge. Notes here are processed, linked, and evergreen. diff --git a/04-resources/CONVENTION.md b/04-resources/CONVENTION.md index b7d37ce..f9e1ac4 100644 --- a/04-resources/CONVENTION.md +++ b/04-resources/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 04-resources +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 04-resources — Raw Reference Material **Purpose:** Source material in its processed-but-not-synthesized form. One step above raw capture, one step below permanent knowledge. diff --git a/04-resources/social-captures/CONVENTION.md b/04-resources/social-captures/CONVENTION.md index 1f4731d..1465054 100644 --- a/04-resources/social-captures/CONVENTION.md +++ b/04-resources/social-captures/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 04-resources/social-captures +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # social-captures — Social Media Content **Purpose:** Store captured social content for later synthesis. Strip engagement bait; keep signal. diff --git a/05-areas/CONVENTION.md b/05-areas/CONVENTION.md index c4bd6f3..99abab3 100644 --- a/05-areas/CONVENTION.md +++ b/05-areas/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 05-areas +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 05-areas — Life Areas **Purpose:** Ongoing life areas that never "complete" — tracked, reviewed, and updated over time. diff --git a/06-goals/CONVENTION.md b/06-goals/CONVENTION.md index 7642b07..461a020 100644 --- a/06-goals/CONVENTION.md +++ b/06-goals/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 06-goals +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 06-goals — Unified Goal System **Purpose:** One place for all goal tracking. Annual vision → quarterly targets → weekly focus. No duplication. diff --git a/07-people/CONVENTION.md b/07-people/CONVENTION.md index 24d1e5c..1445fc9 100644 --- a/07-people/CONVENTION.md +++ b/07-people/CONVENTION.md @@ -1,3 +1,13 @@ +--- +type: system +subtype: convention +folder: 07-people +created: 2026-05-29 +modified: 2026-06-06 +status: active +tags: [convention, systems, ckis] +--- + # 07-people — Relationship Intelligence **Purpose:** Notes on people who matter — clients, mentors, and network. One file per person.