Repository navigation
feat: bootstrap jikan's context-layer documents (backend-suite) - #605
Merged
irfan-dahir merged 1 commit intoOct 11, 2026
Merged
Conversation
Complete the understand-existing-project chain's context-docs step: five
role documents scaffolded as honest stubs (status: stub, resolve exit 5,
counted as design debt until authored), five app/org-shaped roles declined
with written reasons, docs.manifest and survey.json updated.
New stubs (each carries the suite's DECIDE/DERIVED markers for a human to
answer):
- CHANGELOG.md - changelog role
- CONTRIBUTING.md - contributing role
- DECISIONS.md - decisions role
- DEPRECATIONS.md - deprecations role
- API-STANDARD.md - api-standard role (pre-framed for a client library:
jikan consumes MyAnimeList; the standard governs
jikan's own public API surface)
Declined with a reason each (resolve exit 4): brief, backlog, builds,
deployment, production-readiness — library-shaped N/A.
Preflight blocked: 14 -> 9 (the audit-layer-boundaries skill is now
unblocked by the api-standard mapping; the remaining 9 need org/house-style
roles jikan does not have).
survey.json refreshed: 478 files, 0 couldNotDetermine.
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.
Stacked on #604. Completes the
understand-existing-projectchain's context-docs step — the last missing piece of the suite onboarding.What this adds
Five role documents scaffolded as honest stubs (
status: stub→resolveexits 5, counted as design debt until authored, never as coverage):CHANGELOG.mdCONTRIBUTING.mdDECISIONS.mdDEPRECATIONS.mdAPI-STANDARD.mderrorHandlingarch-rulesFive app/org-shaped roles declined with written reasons (
resolveexits 4):brief,backlog,builds,deployment,production-readiness— library-shaped N/A.docs.manifest.jsonupdated (roles + declinedRoles + _readme);survey.jsonrefreshed (478 files, 0 couldNotDetermine).What it unlocks
Preflight blocked: 14 → 9. Newly runnable:
/audit-layer-boundaries(unblocked by the api-standard mapping),/bootstrap-api-docs,/upgrade-apply,/upgrade-measure,/quality-debt,/repo-health. The remaining 9 blocked need org/house-style roles (pr,plans,production-readiness,documentation-rules, …) jikan deliberately does not have as a client-facing library.Points for reviewers
api-standardshape is right for a library is worth a look — I pre-answered only the one knowable DECIDE (client vs backend); the rest need your conventions.