okr/CONTRIBUTING.md

1.8 KiB

Contributing to OKR Offentlig Sektor

Takk for at du vil bidra til OKR-pluginen!

How to Contribute

Reporting Bugs

  1. Check existing issues to avoid duplicates
  2. Open a new issue with:
    • Clear description of the problem
    • Steps to reproduce
    • Expected vs actual behavior
    • Your environment (OS, Claude Code version)

Suggesting Features

  1. Open an issue with the "enhancement" label
  2. Describe the use case and expected behavior
  3. Explain why this would benefit other users
  4. Consider public sector context and constraints

Pull Requests — not accepted

This is a single-maintainer, fork-and-own reference plugin: pull requests are not accepted. See GOVERNANCE.md (section "Pull requests — no") for the rationale and the contribution model. To propose a change, open an issue (see above); to adapt the plugin for your organization, fork it and own the result — the recommended adoption pattern described in GOVERNANCE.md.

Development Setup

  1. Clone the repo
  2. Add to your Claude Code plugins:
    {
      "plugins": ["path/to/okr"]
    }
    
  3. Restart Claude Code
  4. Run /okr to verify installation

Code Style

  • Follow existing patterns in the codebase
  • Use YAML frontmatter for all commands/agents
  • Keep commands focused and single-purpose
  • Norwegian for user-facing text (commands, descriptions)
  • English for code, config, and documentation structure
  • Document new features in README.md

OKR Domain Knowledge

When contributing OKR-related content:

  • Follow Google/Doerr methodology
  • Consider 4-month cycle constraints (Norwegian public sector)
  • Include examples relevant to public sector
  • Reference Oboard tracking where applicable

Questions?

Open an issue with the "question" label.