Skip to content

docs(openspec): propose repo cleanup, AI contributor docs, lean governance and robotcode-first tooling - #24

Merged
manykarim merged 1 commit into
mainfrom
change/streamline-repo
Nov 16, 2026
Merged

manykarim merged 1 commit into
mainfrom
change/streamline-repo

Conversation

@manykarim

Copy link
Copy Markdown
Collaborator

Four OpenSpec change proposals from a review of what this repository still carries from robotframework-agentskills. Planning only: this PR adds files under openspec/changes/ and changes no code, workflow or setting.

Change What it proposes
repo-cleanup Remove dead harness code (domain/events.py, domain/skill.py, parquet_writer.py, unused errors and settings), the unused dependencies scipy, numpy, httpx, polars and pytest-asyncio, the root .mcp.json, update-latest.yml (it force-pushes latest against release.yml), the unused setup-eval action, validate-marketplace.py and the broken Docker harness. Drop duplicate CI steps, move dated plans and reports to docs/archive/, and update specs that still describe the root skills/ folder and sync-skills.sh.
ai-contributor-docs AI_POLICY.md (based on RobotCode's policy, plus rules for skills, generated files and evals), AGENTS.md (with CLAUDE.md importing it), the rule that the robotcode CLI is the base of the RF AI toolstack, PR template items, and project context in openspec/config.yaml. A test keeps AGENTS.md in line with CI.
lean-governance One maintainer approval for outside PRs. Maintainers' own PRs merge once the checks pass, through a ruleset bypass. Removes required-reviews and review-relay (their review teams don't exist, so they can't pass today) and the 2027-01-31 tier_grace cliff. Tiers come from automated evidence. Turns on secret scanning, push protection, Dependabot security updates and auto-merge, and closes out launch-plugin-programme.
robotcode-first-tooling Keyword checks use robotcode analyze code, and the grader uses robotcode robot and robotcode results instead of its own libdoc and output.xml code. The libdoc spec files go away. A guard script with an allowlist blocks new re-implementations. A spike on robotcode 2.8.0 backs the design, and it drafts four robotcode gap issues for review (none filed).

Order, as the proposals describe it:

  1. fix(eval): make task prompts and fixtures read like a real project #20 merges.
  2. lean-governance task 1 archives launch-plugin-programme.
  3. repo-cleanup and ai-contributor-docs follow, in either order.
  4. robotcode-first-tooling comes last and needs a GLM re-baseline after it merges.

The maintainer's decisions from the review are in the "Confirmed decisions" sections of the designs. Each change ends with an initial-check task: once implemented, each decision is checked against the results and changed if it causes problems.

openspec validate --strict passes for all four. lean-governance reports one INFO: it can only be archived after launch-plugin-programme, which its task 1 handles.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FHEmzL3ErAhGQykKWDx2wP

…nance and robotcode-first-tooling

Four planning changes from a review of what the repository still carries
from robotframework-agentskills:

- repo-cleanup: remove dead harness code, unused dependencies, the root
  .mcp.json, a conflicting workflow, an unused action, a broken Docker
  harness and duplicate CI steps; archive dated docs; fix stale specs.
- ai-contributor-docs: AI_POLICY.md, AGENTS.md and the robotcode-first
  rule, plus project context for openspec.
- lean-governance: one maintainer approval for outside PRs, checks do the
  rest; remove the custom review machinery and the 2027-01-31 tier cliff;
  close launch-plugin-programme.
- robotcode-first-tooling: keyword checks and the grader use the robotcode
  CLI, with a guard against new re-implementations.

Planning only; no code changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FHEmzL3ErAhGQykKWDx2wP
@manykarim
manykarim merged commit a575915 into main Nov 16, 2026
28 checks passed
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