Documentation and header comments that no longer match the code

オープン
#2,725 コメント 5 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 5 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
3〜5日
初心者へのやさしさ
55/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
markdown, shell, typescript
領域
documentation

調査の方向性

This is a batch of about 40 stale doc and comment claims, each with a file and line plus the code that contradicts it. Pick a single row, such as the DriftReminder budget in LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:257 checked against hooks/DriftReminder.hook.ts:28, and confirm the code still says what the issue reports. Correct only the doc text to match the code, and split the batch into several pull requests grouped by file. Done means each row you take is fixed and the stated evidence no longer conflicts with the source.

索引モデルが issue の本文から書いたものです。

説明

[!NOTE]
🤖 Paulino (AI assistant) responding on behalf of Dr. Paulo

Summary

Each line was checked against the release code. The evidence is in the last column.

line what it says that is not so evidence
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:257 DriftReminder has a 1-per-5-turns budget with dedupe "Every turn, no rate limit" (hooks/DriftReminder.hook.ts:28)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:378 DeployRegistrationGate blocks end-of-turn it is in ADVISORY_GATES (hooks/StopGates.hook.ts:112)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:388 review-state.json is mirrored for the statusline nothing under LIFEOS/STATUSLINE reads it
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:486 ISAStaleWriteGuard is a PostToolObserver member retired 2026-10-24 (hooks/PostToolObserver.hook.ts:15)
LIFEOS/DOCUMENTATION/Hooks/HookSystem.md:1469 AlgorithmNudge does skill-routing and depth on prompt submit those rows were cut (hooks/AlgorithmNudge.hook.ts:829-833)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:152 MemoryRetriever is a pure function it writes generation and index files (LIFEOS/TOOLS/MemoryRetriever.ts:969-972)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:166 the reviewer needs idle_minutes >= 2 no idle condition (hooks/MemoryReviewFire.hook.ts:366); same at LIFEOS/DOCUMENTATION/LifeosSystemArchitecture.md:336
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:251 cap pressure warns at >=44/48 warns at >=46 (LIFEOS/TOOLS/MemoryHealthCheck.ts:422)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:313 KNOWLEDGE holds People / Companies / Ideas / Research six types (LIFEOS/TOOLS/KnowledgeSchema.ts:37)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:409 5 object types six, with book (LIFEOS/TOOLS/KnowledgeSchema.ts:37)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:416 _index.md has a seedlings section it has "Low Quality (need development)" (LIFEOS/TOOLS/KnowledgeHarvester.ts:726-728)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:719 LearningPatternSynthesis does not read the live feedback ledger it reads Errata (LIFEOS/TOOLS/LearningPatternSynthesis.ts:97)
LIFEOS/DOCUMENTATION/Memory/MemorySystem.md:728 ActivityParser is analysis only --generate writes a file (LIFEOS/TOOLS/ActivityParser.ts:646-647)
skills/Cortex/References/CompleteGuide.md:438 ContextSearch searches five sources six, with project ISAs (skills/Cortex/Tools/ContextSearch.ts:70)
skills/Cortex/References/CompleteGuide.md:469 JSONL search stays in this install's conversation dir it searches every project dir (skills/Cortex/Tools/ContextSearch.ts:550-556)
LIFEOS/TOOLS/Services.ts:129 the deriver regenerates Data-Plane pages its plist runs LearningPatternSynthesis --hypothesize (LIFEOS/PULSE/com.lifeos.deriver.plist:12-13)
LIFEOS/TOOLS/Services.ts:180 DerivedSync regenerates Data-Plane pages those rebuilds were retired 2026-10-14 (LIFEOS/TOOLS/DerivedSync.ts:7-9)
LIFEOS/TOOLS/Services.ts:218 CommitmentSweep sweeps commitments and reminders it queries only Type:commitment (LIFEOS/TOOLS/CommitmentSweep.ts:117)
LIFEOS/TOOLS/WorkSweep.ts:15, LIFEOS/TOOLS/CommitmentSweep.ts:15, LIFEOS/TOOLS/UsageAggregator.ts:13, LIFEOS/PULSE/modules/usage.ts:14, LIFEOS/TOOLS/InstallDerivedSync.ts:4, LIFEOS/DOCUMENTATION/Work/WorkSystem.md:85 only launchd runs them the installers also create systemd user units on Linux (LIFEOS/TOOLS/InstallUsageAggregator.ts:112-136)
CLAUDE.template.md:111 the statusline reads LIFEOS_STATE.json it reads USER/STATE/current.json (LIFEOS/STATUSLINE/sections/StateRow.ts:65)
LIFEOS/TOOLS/AgentState.ts:11 AgentWatchdog and CarrierProbe consume agent-starts.json CarrierProbe never names it; AgentWatchdog reads subagent-starts.json (LIFEOS/TOOLS/AgentWatchdog.ts:46)
LIFEOS/DOCUMENTATION/Skills/SkillSystem.md:342 FailureToCase turns execution.jsonl into cases it takes --prompt/--banned/--expect and never reads that file
LIFEOS/DOCUMENTATION/Tools/Tools.md:748 "INSTALL.md § Capability check" no such section; there is "Capability gate" (skills/LifeOS/INSTALL.md:35)
hooks/README.md:286 WorkCompletionLearning depends on the Inference API no inference call (hooks/WorkCompletionLearning.hook.ts:60-65)
hooks/README.md:496 WorkCompletionLearning uses learning-readback.ts its only importer is hooks/LoadContext.hook.ts:50
AlgorithmUpgrade.md:30 (step 2d) reads ROOT_CAUSE_ANALYSIS.md no tool writes it; LIFEOS/TOOLS/MemoryRetriever.ts:276 only skips it
LIFEOS/TOOLS/MemoryHealthCheck.ts:398 the next write silently erases the invalid entry with a ledger head the write is refused (LIFEOS/TOOLS/MemoryWriter.ts:976-988)
LIFEOS/ROUTER/Depth.ts:6 AlgorithmNudge's depth row is a consumer that row was cut (hooks/AlgorithmNudge.hook.ts:829-833)
hooks/AlgorithmNudge.hook.ts:8, hooks/AlgorithmNudge.hook.ts:36, hooks/AlgorithmNudge.hook.ts:49, hooks/AlgorithmNudge.hook.ts:55 the header documents the routing, depth and doctrine rows run() no longer emits them (hooks/AlgorithmNudge.hook.ts:829-833)
derived-artifacts.json:17 the per-turn AlgorithmNudge refreshes skill-usewhen-index.json loadIndex() has no caller (hooks/AlgorithmNudge.hook.ts:691); only --rebuild-index writes it
hooks/StopGates.hook.ts:20 the first blocking gate wins all blocking reasons are joined (hooks/StopGates.hook.ts:136)
hooks/VoiceCompletion.hook.ts:15 the main-session check reads kitty-sessions/{sessionId}.json it checks CLAUDE_CODE_AGENT_TASK_ID (hooks/VoiceCompletion.hook.ts:38-40)
hooks/lib/transcript-evidence.ts:13 the module fails open and never blocks a Stop strict mode throws TranscriptUnreadableError (hooks/lib/transcript-evidence.ts:78)
hooks/lib/context-reduction-core.ts:8 the shell hook stays the command-hook path ContextReduction.hook.sh is retired (RETIREMENTS.json:3247)
LIFEOS/TOOLS/ProseInCode.ts:20 default scan is hooks, LIFEOS, skills, test DEFAULT_SCAN differs and skips tests (LIFEOS/TOOLS/ProseInCode.ts:32)
LIFEOS/TOOLS/IntegrityCheck.ts:1183-1187 fetch-timeouts is file-level and non-blocking it judges each call (LIFEOS/TOOLS/IntegrityCheck.ts:1391) with a budget of 0 (LIFEOS/TOOLS/IntegrityCheck.ts:305)
LIFEOS/TOOLS/GetCounts.ts:18 LIFEOS_StatusLine.sh must use GetCounts the statusline renderer never calls it; only Banner.ts does
主要言語
TypeScript
スター
19.9k
フォーク
2.5k
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

danielmiessler/LifeOS のほかの issue

danielmiessler/LifeOS の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。