Skip to content

docs(issues): Center reports on user stories - #2615

Open
krishicks wants to merge 1 commit into
mainfrom
hicks/push-xxukxkwurqtv
Open

docs(issues): Center reports on user stories#2615
krishicks wants to merge 1 commit into
mainfrom
hicks/push-xxukxkwurqtv

Conversation

@krishicks

Copy link
Copy Markdown
Collaborator

Summary

OpenShell is an agent-first project, but it's also a project that is, as of today, managed by humans. To facilitate humans' management of the project, we should revise the guidance for creating new issues and PRs to be centered more around what a persona needs, why that need isn't being met, and what the impact of that need not being met is. This will allow us (humans) to more effectively triage issues and mark them as accepted or place them on the roadmap, hopefully resulting in quicker time-to-resolution for issues.

Related Issue

Changes

  • Use the same compact persona, workflow, impact, reproduction, and environment prompts for bug reports and feature requests. Keep logs optional and specific to bug reports.
  • Remove filing-time agent diagnostics so maintainers can evaluate user needs apart from investigation output, which becomes stale over time. Require contributors to investigate current behavior after humans accept the work, and treat state:accepted or roadmap placement as that signal.

Testing

  • mise run pre-commit passes
  • Unit tests added/updated
  • E2E tests added/updated (if applicable)

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)
  • Architecture docs updated (if applicable)

Use the same compact persona, workflow, impact, reproduction, and
environment prompts for bug reports and feature requests. Keep logs
optional and specific to bug reports.

Remove filing-time agent diagnostics so maintainers can evaluate user needs
apart from investigation output, which becomes stale over time. Require
contributors to investigate current behavior after humans accept the work, and
treat state:accepted or roadmap placement as that signal.

Signed-off-by: Kris Hicks <khicks@nvidia.com>
rhuss added a commit to rhuss/OpenShell that referenced this pull request Aug 5, 2026
Fix OCSF scope claim: OCSF runs on both sandbox and gateway sides
(TLS events, service routing, policy), not sandbox-only. Correct VM
driver instrumentation count from "10+ using ErrorStatusGuard" to
"15 instrumented operations (9 via instrument, 6 via .instrument())
and ErrorStatusGuard for error marking". Note that K8s and Podman
drivers are dual-mode (in-process default + standalone gRPC binary).
Clarify NVIDIA#2615 is a PR, not an issue.

Signed-off-by: Roland Huß <rhuss@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant