Skip to content

docs(workflow): simplify authorship rules and drop stale skill metadata - #75

Closed
kaikisegfault wants to merge 1 commit into
mainfrom
docs/natural-authorship
Closed

kaikisegfault wants to merge 1 commit into
mainfrom
docs/natural-authorship

Conversation

@kaikisegfault

Copy link
Copy Markdown
Owner

Outcome and scope

Documentation-only. States the repository identity once rather than enumerating prohibited attribution cases, and clears references to skill interface metadata that the current layout no longer uses.

  • CLAUDE.md and docs/engineering/git-workflow.md keep the owner identity and the existing bot-automation allowance, dropping the enumerated attribution prohibitions.
  • The identity is recorded as the GitHub username kaikisegfault rather than a display name, matching the configured Git identity.
  • .github/pull_request_template.md drops the corresponding checklist item.
  • docs/engineering/verification.md and .claude/skills/verify-project/SKILL.md no longer reference agents/openai.yaml, which no longer exists, and the metadata gate is described as parsing settings JSON rather than TOML — matching what tools/verify_metadata.py actually does.

Protocol, compatibility, economic, and security effects

None. No consensus-visible type, encoding, state transition, economic rule, or cryptographic behavior is touched, and no verifier logic changes.

Verification

$ python3 tools/verify_metadata.py
Validated 5 repository skills and 19 internal Markdown links.

$ python3 tests/tools/verify_metadata_test.py
Ran 3 tests — OK

$ python3 tests/tools/verification_scope_test.py
Ran 3 tests — OK

Expected to classify as lightweight: the changed set is Markdown only.

Known limitations and follow-up

The stale agents/openai.yaml references corrected here were missed when the layout moved, because that sweep matched on codex, AGENTS.md, and .agents/ but not on the metadata filename itself.

State the repository identity once instead of enumerating prohibited
attribution cases, and correct references to skill interface metadata that the
Claude Code layout no longer uses.

- Reduce the authorship rules in CLAUDE.md and git-workflow.md to the owner
  identity plus the existing bot-automation allowance, and drop the matching
  pull-request checklist item.
- Record the identity as the GitHub username rather than a display name.
- Remove the remaining agents/openai.yaml references from verification.md and
  the verify-project skill, and describe the metadata gate as parsing settings
  JSON rather than TOML, matching the current verifier.

Verification: tools/verify_metadata.py passes (5 skills, 19 links);
tests/tools/verify_metadata_test.py and
tests/tools/verification_scope_test.py pass (3 tests each).
@kaikisegfault
kaikisegfault deleted the docs/natural-authorship branch August 3, 2026 19:24
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