Adopt spec-kit + Claude workflow: constitution v1.0.0 + AGENTS.md#91
Open
yarikoptic wants to merge 2 commits into
Open
Adopt spec-kit + Claude workflow: constitution v1.0.0 + AGENTS.md#91yarikoptic wants to merge 2 commits into
yarikoptic wants to merge 2 commits into
Conversation
=== Do not change lines below ===
{
"chain": [],
"cmd": "specify init .",
"exit": 0,
"extra_inputs": [],
"inputs": [],
"outputs": [],
"pwd": "."
}
^^^ Do not change lines above ^^^
Populate .specify/memory/constitution.md (previously template placeholders only) with five principles centred on the project's actual ideals: comprehensive contributor acknowledgement, named-contributor fields are sacred, pluggable parsers + shared .tributors cache, automation across equivalent surfaces (library/CLI/container/Action), and identity resolution with human-in-the-loop. Add AGENTS.md at the repository root as the canonical guidance file for AI agents (Claude Code, Codex, Cursor, Aider, …) and humans wanting a quick orientation — preserves the prior build/test/code-style content, adds a spec-kit command cheat-sheet, and points to the constitution as required reading. CLAUDE.md (locally excluded) is symlinked to AGENTS.md. Principle II is intentionally scoped to the *named* contributor fields (`name`, `email`, `affiliation`, `orcid`, `blog`/`profile`, `bio`) — the exact set the codebase currently protects in its merge logic. List ordering across runs is a SHOULD, not a MUST. The Quality Gates "Style" item notes that `black`/`pyflakes` are operator-installed today; promoting the gate to a MUST in CI is the only listed deferred TODO. Co-Authored-By: Claude Code 2.1.143 / Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Bootstrap the spec-kit + Claude workflow for this repository. This PR
is a governance + tooling change, not a behaviour change — no Python code
in
tributors/is touched..specify/scaffolding (commit ed9d07a, [DATALAD RUNCMD]):introduces
.specify/{templates,scripts,workflows,integrations, extensions,memory}/, the.specify/extensions.ymlhook config, andthe per-command skills under
.claude/skills/speckit-*/that back the/speckit.*slash-commands..specify/memory/constitution.md, commitcae8c99): five principles ratified, centred on what Tributors is
for — adequate contributor acknowledgement and automation of the
bookkeeping that has historically been manual.
AGENTS.mdat the repo root (new, commit cae8c99): canonicalentry point for AI agents (Claude Code, Codex, Cursor, Aider, …) and
for humans wanting a quick orientation. Preserves the prior CLAUDE.md
build/test/style content and points to the constitution as required
reading.
Why this is the starting point
Going forward, non-trivial work on this repo flows through spec-kit's
phased commands:
Each phase produces a reviewable artifact under
specs/<###-feature>/(spec → plan → research/data-model/contracts/quickstart → tasks). The
constitution is the gate every plan is checked against, so it is
ratified first. AGENTS.md is the shared entry point that AI agents
load before proposing changes, so it is created at the same time.
What is intentionally not in this PR
notes that
black/pyflakesare operator-installed today and notwired into CI; promoting them to a CI-enforced MUST is the one
recorded deferred TODO and will land in a follow-up PR.
/speckit.specifyetc.Constitution principles (ratified at v1.0.0)
bots excluded because not people.
truthy,
name/email/affiliation/orcid/blog/bioin any managed contributor file MUST NOT be overwritten by an
automated run. (Scoped to named fields to match what the codebase
actually enforces; container-structure ordering is a SHOULD.)
ParserBasesubclass; cross-parser state flows through.tributorsindexed by GitHub login.
and GitHub Action stay in lockstep with matching options.
prompt (or skip); never silently guess.
Plus normative sections on Metadata & Standards Compliance and
Development Workflow & Quality Gates, and a Governance section
designating AGENTS.md as the constitution's delegate for day-to-day
conventions.
Files touched
.specify/memory/constitution.md(template placeholders → ratifiedv1.0.0)
AGENTS.md(new; canonical AI-agent guidance).specify/scaffolding in ed9d07a)CLAUDE.mdis locally excluded (.git/info/exclude) and symlinked toAGENTS.mdon the contributor's checkout; it is not tracked.Test plan
.specify/memory/constitution.mdon GitHub; verify SyncImpact Report (HTML comment) is hidden in the rendered view and
principle headings are at the right level.
AGENTS.mdon GitHub; verify the spec-kit command tableis column-aligned in source and renders cleanly.
/speckit.specify "<some toy feature>"in a follow-upbranch to confirm the spec-kit + constitution loop works
end-to-end against this baseline.