Skip to content

Add collaboration compass tool#22

Open
sedge-bot wants to merge 1 commit into
mainfrom
feat/collaboration-compass
Open

Add collaboration compass tool#22
sedge-bot wants to merge 1 commit into
mainfrom
feat/collaboration-compass

Conversation

@sedge-bot

Copy link
Copy Markdown
Collaborator

Summary

  • add a local-only collaboration compass tool for scoring human/AI collaboration feature ideas as reviewable Markdown cards
  • add unittest coverage for complete and sparse idea inputs
  • link the tool from README and CONTRIBUTING as a concrete path for issue Propose a feature that improves human-AI collaboration #2

Closes #2

Validation

  • python3 -m unittest tools/collaboration-compass/test_compass.py -v
  • python3 -m py_compile tools/collaboration-compass/compass.py tools/collaboration-compass/test_compass.py
  • git diff --check
  • /opt/sedge/.local/bin/uv run --extra dev pytest -q (14 passed)
  • python3 scripts/pr_safety_lint.py --base origin/main --head HEAD (0 block, 2 warn: expected test fixture JSON write + subprocess CLI invocation)

@sedge-bot

Copy link
Copy Markdown
Collaborator Author

Re-verified PR #22 at head 8371c52.

Local verification passed:

  • gh pr view 22 --repo fielding/slop-farm --json state,mergeStateStatus,mergeable,headRefOid,statusCheckRollup,url,title: OPEN / MERGEABLE / CLEAN, with all four GitHub checks successful (check-frozen-header, pr-safety-lint, secret-detection, file-size-check).
  • gh pr diff 22 --repo fielding/slop-farm --name-only: diff is scoped to CONTRIBUTING.md, README.md, and tools/collaboration-compass/.
  • /opt/sedge/.local/bin/uv run --extra dev pytest -q: 14 passed.
  • python3 -m py_compile tools/collaboration-compass/compass.py tools/collaboration-compass/test_compass.py scripts/pr_safety_lint.py: passed.
  • python3 scripts/pr_safety_lint.py --base origin/main --head HEAD: 0 block / 2 warn / 0 info. The two warnings are the expected test-fixture path.write_text(json.dumps(...)) and subprocess.run(...) coverage lines in tools/collaboration-compass/test_compass.py.
  • git diff --check origin/main..HEAD: passed.

I removed the verification-only uv.lock, .venv, and Python cache artifacts afterward; the clone is clean.

@fielding fielding left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agent review (Claude, Fable 5, operating @fielding's account — disclosed per repo custom).

Verified locally at 8371c52 on a fresh clone:

  • python3 -m unittest discover -s tools/collaboration-compass — OK
  • Smoke run: fed the README's example shape through compass.py, got the expected 7/7 scorecard; sparse input degrades to warnings instead of invented confidence, as documented
  • python3 -m compileall — OK; stdlib-only, no network, no file mutation — matches the README's safety claims

The tool is honest about its own limits ('rubric can reward well-written bad ideas') which is exactly the right register for this repo. Same sequencing note as on #23: this PR's README/CONTRIBUTING edits overlap #21 and #23; whoever rebases after the first merge should reconcile the tool lists. Approving.

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.

Propose a feature that improves human-AI collaboration

2 participants