odkrywaj-organizator

odkrywaj-organizator

A Claude Code plugin that gives any project persistent memory across sessions. Scaffold 8 organizator markdown files + optional hooks in one command.

---

The problem

Claude Code forgets. Every new session starts with ten minutes of re-explaining the project: what you're building, what's already done, what you tried and rejected, why the architecture is the way it is. On a growing codebase this gets worse, not better.

The fix

One magic word drops 8 small markdown files in your project root. Claude reads them on demand — STARTWORK.md first as a router, then pulls only what the current task needs. Optional hooks auto-load context on every session start and trigger a wrap-up checklist when you close out.

You: Organizuj!
Claude: [scans project] [asks 3 questions] [writes 8 organizator files]
        Done. Start a fresh session and say "pracujemy nad projektem".

How it works

┌─────────────────────────────────────────────────────────────┐
│  SESSION START                                              │
│     │                                                       │
│     ▼                                                       │
│  Hook reads STARTWORK.md  ──►  Claude knows the project     │
│     │                                                       │
│     ▼                                                       │
│  Task needs specifics?                                      │
│     │                                                       │
│     ├──► architecture    ──►  reads DECISIONS.md            │
│     ├──► find a file     ──►  reads FILEMAP.md              │
│     ├──► propose a dep   ──►  reads TECHSTACK.md            │
│     └──► where we are    ──►  reads PROGRESS.md             │
│                                                             │
│  SESSION END — you type "kończymy" / "endwork" / "gg"       │
│     │                                                       │
│     ▼                                                       │
│  Hook injects ENDWORK.md  ──►  Claude updates organizator   │
└─────────────────────────────────────────────────────────────┘

The 8 organizator files

File	Role
STARTWORK.md	Router. Read first. Points to the other seven.
CONTEXT.md	What you're building, for whom, what you're explicitly NOT building.
FILEMAP.md	Where things live. Prevents Claude from re-discovering layout.
TECHSTACK.md	Stack, key deps, versions that matter, what you're not using.
WORKFLOW.md	Run / test / deploy commands. Git conventions.
PROGRESS.md	Done / in progress / next / blocked + dated session log.
DECISIONS.md	Append-only log of why. Stops "we already rejected that" loops.
ENDWORK.md	Wrap-up checklist. Auto-triggered on session close.

See skills/odkrywaj-organizator/references/examples.md for fully populated examples on three contrasting projects: a SvelteKit learning platform, a content marketing agency, and a solo Rust learning project.

Install

Recommended — Claude Code plugin

In any Claude Code session:

/plugin marketplace add odkrywaj-ai/odkrywaj-organizator
/plugin install odkrywaj-organizator

Done. The skill is available globally in every project.

Fallback — one-liner installer

For setups without plugin support:

curl -fsSL https://raw.githubusercontent.com/odkrywaj-ai/odkrywaj-organizator/main/install.sh | bash

The script clones the repo to ~/.claude/skills/odkrywaj-organizator and verifies the install. No system-level changes, no sudo.

Manual (if you prefer to read what you run)

mkdir -p ~/.claude/skills
git clone https://github.com/odkrywaj-ai/odkrywaj-organizator.git ~/.claude/skills/odkrywaj-organizator-plugin
ln -s ~/.claude/skills/odkrywaj-organizator-plugin/skills/odkrywaj-organizator ~/.claude/skills/odkrywaj-organizator

Verify

Start a new Claude Code session in any project and type one of the magic words:

• Organizuj!
• ustaw organizatora
• Accio organizator (for fans of a certain wizard)
• bootstrap organizator
• set up organizator files

Claude will scan your project, ask a few questions, and scaffold the 8 organizator files.

Requirements

• Claude Code installed
• bash, git
• jq recommended (hooks use it; scanner degrades gracefully without it)
• tree optional (scanner falls back to find)

Update

Plugin install: /plugin update odkrywaj-organizator in Claude Code.

Script install:

cd ~/.claude/skills/odkrywaj-organizator && git pull

Uninstall

Plugin install: /plugin uninstall odkrywaj-organizator.

Script install: