[External Plugin]: keep-the-why

[oliver-zehentleitner-aigent]

Plugin name

keep-the-why

Short description

Preserves or recovers the reasoning behind a codebase — architectural decisions, rejected alternatives, workarounds, incident learnings, operational constraints, and historical context the code itself cannot explain.

GitHub repository

oliver-zehentleitner/keep-the-why

Plugin path inside the repository

No response

Ref to review

v0.5.2

Commit SHA to review

No response

Version

0.5.2

License identifier

MIT

Author name

Oliver Zehentleitner

Author URL

https://github.com/oliver-zehentleitner

Homepage URL

https://keepthewhy.com

Keywords

documentation
context
decision-log
knowledge-management
onboarding
agents

Additional notes for reviewers

Skill-only plugin (skills: ["skills/"] in plugin.json, pointing to skills/keep-the-why/SKILL.md). Also distributed via skills.sh using a moving latest tag; this submission intentionally pins to the immutable v0.5.2 release tag instead (v0.5.1 predated plugin.json), per this repository's immutable-ref requirement for external plugins.

Submission checklist

• The plugin lives in a public GitHub repository.
• The ref and/or sha I provided is immutable (release tag and/or full 40-character commit SHA), not a branch.
• This submission follows this repository's contribution, security, and responsible AI policies.
• This plugin is not already listed in the Awesome Copilot marketplace.

[github-actions]

🟡 Contributor Reputation Check: MEDIUM risk

Check	Risk
Profile	MEDIUM
Credential audit	NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

[github-actions]

✅ External plugin intake passed

This submission passed automated intake validation and quality checks and is ready for maintainer review.

• Plugin: keep-the-why
• Repository: https://github.com/oliver-zehentleitner/keep-the-why
• Ref: v0.5.2

Quality gate summary

Gate	Status
vally lint	pass
install smoke test	pass
version match	pass
canvas structure	not_run

• vally lint: pass
• install smoke test: pass
• version match: pass
• canvas structure: not_run
• overall: pass

vally lint output

✅ keep-the-why (3/3 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.
    ✓ [orphan-files] No orphan files found across 1 skill(s).
        ✓ orphan-files: All 8 file(s) in references/ are reachable from SKILL.md.

1 skill(s) linted, 1 passed

Install smoke test output

Install smoke test succeeded. Verified /tmp/external-plugin-quality-DnbovC/copilot-home/.copilot/installed-plugins/external-plugin-intake/keep-the-why/plugin.json.

Version match output

- v0.5.2: matched version "0.5.2" at "plugin.json".

Canvas structure output

Canvas structure gate skipped because plugin is not tagged with "canvas".

Canonical external.json payload

{
  "name": "keep-the-why",
  "description": "Preserves or recovers the reasoning behind a codebase — architectural decisions, rejected alternatives, workarounds, incident learnings, operational constraints, and historical context the code itself cannot explain.",
  "version": "0.5.2",
  "author": {
    "name": "Oliver Zehentleitner",
    "url": "https://github.com/oliver-zehentleitner"
  },
  "repository": "https://github.com/oliver-zehentleitner/keep-the-why",
  "homepage": "https://keepthewhy.com",
  "license": "MIT",
  "keywords": [
    "documentation",
    "context",
    "decision-log",
    "knowledge-management",
    "onboarding",
    "agents"
  ],
  "source": {
    "source": "github",
    "repo": "oliver-zehentleitner/keep-the-why",
    "ref": "v0.5.2"
  }
}

View workflow run