life-itself / life-itself/reasoncommons
Bring selected existing GitHub issues into the Reason Commons commons without duplicates
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 1
- Forks
- 0
- Avg merge
- 4h 59m
- Merged PRs (30d)
- 11
Description
life-itself/reasoncommons should remain David and Rufus's familiar collaboration surface while its work becomes connected to the app-development commons' goal and reasoning. The inspected app sync service projects accepted actions and reconciles existing mappings; creating an issue here must not be assumed to import it into the app.
## Work
- Verify and document actual connection behavior, then support selecting a small set of existing issues for inbound review.
- Preserve repository/issue identity, source URL, source revision and supporting excerpts.
- Interpret an issue according to its content: action, question, problem, hypothesis or several related items. Do not force every issue into one transition action.
- Keep inferred relationships and expected effects provisional; distinguish completion criteria from observed outcomes.
- On acceptance of an action, adopt its original issue mapping rather than create another issue; preserve human-written content.
- Handle repeat imports, interrupted retries and later issue edits without silently rewriting accepted reasoning.
## Acceptance criteria
Using selected real issues, an import creates bounded proposals with source links. Acceptance adopts the original action issue, rerunning does not duplicate proposals or issues, and a later source edit produces a reviewable difference. Issue closure records reported completion and does not declare success or increase throughput automatically.
## Expected benefit and check
David and Rufus can explain why selected work matters and what it should change while continuing to work from GitHub. Compare the effort of this small workflow with manually maintaining both places before expanding to continuous ingestion.
Depends on the app-development commons being established and the relevant import/review path being reliable. Related: #23 (machine-readable repository exports), which is the outward reasoning-document path, not this inbound issue path.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by inspecting the app sync service and the relevant import/review path, then review related issue #23 for the boundary between inbound imports and outward exports. Done means selected real issues produce bounded proposals with source links, acceptance reuses the original action issue, reruns do not duplicate work, later edits are reviewable, and closure records completion without declaring success.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github
- Domain
- backend-api-design
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100