Should I use this for task-specific progress tracking?

No, task-specific notes are better suited for your issue tracker. The journal is designed for cross-cutting insights, architectural discoveries, and persistent lessons learned.

How does the journal distinguish between human and AI entries?

The skill uses an immutable filename suffix (.ai. or .hu.) to identify the original author, allowing users to verify the source of any observation at a glance.

Can I search my journal entries later?

Yes, you can search entries using simple glob patterns for filenames or standard grep commands to find specific keywords across all journal contents.

Where are the journal entries stored?

All entries are stored as standard Markdown files within your project's notes/journal/ directory for easy version control and portability.

What is the 'promotion' process for journal entries?

Raw entries gain authority through promotion, which involves linking them from hub files like notes/INDEX.md or moving them into the primary documentation folder.

Knowledge Journal

Name: Knowledge Journal
Author: a3lem

bya3lem

0•

Productivity & Workflow

Captures and preserves development insights, architectural observations, and lessons learned in a timestamped, searchable log.

The Knowledge Journal skill enables Claude to maintain a structured development log within your repository, capturing ephemeral knowledge that often disappears between sessions. By automating the creation of timestamped markdown files with clear authorship markers, it helps teams track non-obvious code behaviors, design insights, and workarounds. The system includes built-in logic for categorizing notes by trust level and provides a streamlined workflow for promoting raw observations into durable, long-term project documentation.

Key Features

01Structured organization using YAML frontmatter for tags and cross-references

020 GitHub stars

03Consolidation workflow for archiving stale entries into permanent project documentation

04Automated timestamped entry creation with AI vs. human authorship tracking

05Authority-based ranking system to prioritize human-validated insights over raw AI notes

06Searchable knowledge base stored directly in your repository under notes/journal/

Use Cases

01Recording non-obvious codebase discoveries or 'gotchas' encountered during debugging

02Maintaining a persistent log of lessons learned to prevent repeating mistakes in future sessions

03Documenting architectural design insights and trade-offs during complex refactoring

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add a3lem/my-claude-plugins journal

For use in Claude.ai and ChatGPT