Skip to content

feat(agent-kb): SecondBrain agent-friendly index.md + Obsidian Linter config#11

Merged
epicsagas merged 1 commit into
mainfrom
worktree-orbit-secondbrain-agent-knowledge-base
May 16, 2026
Merged

feat(agent-kb): SecondBrain agent-friendly index.md + Obsidian Linter config#11
epicsagas merged 1 commit into
mainfrom
worktree-orbit-secondbrain-agent-knowledge-base

Conversation

@epicsagas

Copy link
Copy Markdown
Owner

Summary

SPEC: SPEC-secondbrain-agent-knowledge-base.md Phase 1 (기반) 구현.
LLM 에이전트가 볼트를 자율 탐색할 수 있는 정적 진입점과 Obsidian Linter 자동 설정.

Spec

  • ID: SPEC-secondbrain-agent-knowledge-base
  • Pipeline: PIPELINE-20260513183122
  • Requirements: R1, R6, F3

Changes

  • src/index.rs (신규): generate_index() — 볼트 루트에 index.md 생성 (멱등성 보장)
  • src/init.rs: ensure_linter_config(), ensure_community_plugin() 추가
  • src/main.rs: of graph index CLI 명령 추가, sync cycle에 index.md 생성 연동
  • AGENTS.md: 에이전트 탐색 경로 섹션 추가 (index.md → wikilink → alcove BM25)
  • Cargo.toml: dev-dependency tempfile 추가

Acceptance Criteria Verified

  • AC1: index.md 볼트 루트 자동 생성 ✅
  • AC2: Areas/Projects/ZK 계층적 wikilink 정적 구조 ✅
  • AC3: AGENTS.md에서 에이전트 진입점 명시 ✅
  • AC4: of init / of sync / of graph index 자동 생성 ✅
  • AC5: Linter data.json 생성 (기존 설정 보존) ✅
  • AC6: community-plugins.json append-only 관리 ✅

Check Report

## Check Report
- Spec: SPEC-secondbrain-agent-knowledge-base (secondbrain-agent-knowledge-base)
- Branch: worktree-orbit-secondbrain-agent-knowledge-base
- Scopes: [Backend, Docs, Tests]

### Scores
- Code Quality: PASS
- Security:     PASS
- Performance:  PASS
- Tests:        78/78 passing

### Requirements
- R1 (index.md 에이전트 진입점): ✅
  - `index.md` 볼트 루트에 자동 생성
  - Areas / Active Projects / Zettelkasten / Key Concepts / Governance 섹션
  - `of init`, `of sync`, `of graph index` 모두 연동
  - 멱등성 보장 (내용 변경 시만 파일 쓰기)
- R6 (Obsidian Linter 설정): ✅
  - `.obsidian/plugins/obsidian-linter/data.json` 생성
  - `community-plugins.json` 관리
  - `of init`, `apply_global_settings`, `push_settings` 3곳 연동
  - 기존 사용자 설정 보존 (overwrite 없음)
- F3 (AGENTS.md 탐색 경로): ✅
  - "Agent Navigation Path" 섹션 추가
  - index.md → wikilink 순회 → alcove BM25 폴백 경로 명시

### Acceptance Criteria
- AC1: `index.md` 볼트 루트에 존재 ✅
- AC2: 계층적 wikilink 정적 구조 ✅
- AC3: AGENTS.md에서 진입점 명시 ✅
- AC4: `of init`/`of sync` 자동 생성 ✅
- AC5: Linter data.json 생성 (기존 설정 보존) ✅
- AC6: community-plugins.json 관리 ✅

### Action Items
none

Test Plan

  • 78 unit tests pass
  • cargo clippy -D warnings clean
  • cargo fmt --check clean
  • cargo build (dev) pass

R1: generate agent-friendly index.md at vault root
- Static wikilinks to Areas, Active Projects, Zettelkasten, Key Concepts
- Idempotent: only writes when content changes
- Auto-runs on of init, of sync, of graph index

R6: auto-configure Obsidian Linter plugin on vault init
- Creates .obsidian/plugins/obsidian-linter/data.json with yaml rules
- Manages community-plugins.json (append-only, no duplicates)
- Wired into of init, settings apply-global, settings push
- Preserves existing user config (no overwrite)

F3: document agent navigation path in AGENTS.md
- index.md -> wikilink traversal -> alcove BM25 fallback
@epicsagas epicsagas merged commit 769851a into main May 16, 2026
10 checks passed
@epicsagas epicsagas deleted the worktree-orbit-secondbrain-agent-knowledge-base branch May 16, 2026 10:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant