nori-skillsets: Instructions file for Codex

Plugin package changes.

All changes must be compatible on MacOS and Linux. Be careful of using bash tools that may behave differently on different systems.

Claude Code configuration vs. Nori Plugin package

IMPORTANT: When discussing "Claude" or "Claude Code configuration":

• Almost always means modifying files in src/cli/features/claude-code/ (the Nori Plugin package)
• Rarely means modifying ~/.claude/ (the installed user configuration)

Default assumption: Unless explicitly stated otherwise, "modify Claude configuration", "update skills", "change hooks", etc. refers to modifying the Plugin package source files at src/cli/features/claude-code/, NOT the installed configuration at ~/.claude/.

Examples:

• "Change the status line" → Modify src/cli/features/claude-code/statusline/

Note: No built-in profiles are shipped with the package. Profiles (skillsets) are stored at ~/.nori/profiles/ and are obtained from the registry or created by users.

Only modify ~/.claude/ when:

• User explicitly says "my installed configuration" or "~/.claude/"
• Testing changes locally before committing to the package

Skills documentation.

Skills in ~/.nori/profiles/<skillset>/skills/ are self-explanatory. Do not create docs.md files in skill directories unless the skill is particularly complex and requires additional context files.

Style guide.

Functions and named parameters.

All functions except class functions should be arrow functions. All of them should use named args, even if there is a single parameter. Follow this pattern throughout:

const foo = (args: { bar: string; baz: number }) => {
  const { bar, baz } = args;
};

To set defaults, use the 'withDefaults' helper found in server/src/utils/defaults.ts or ui/src/utils/defaults.ts:

import { withDefaults } from '@/utils/defaults';

const foo = (args: { bar?: string; baz?: number }) => {
  const { bar, baz } = withDefaults(args, { bar: 'hello', baz: 10 });
};