docs(issue-1): bootstrap AI development workflow #2

Merged
rznz merged 3 commits from docs/1-bootstrap-ai-workflow into main 2026-09-20 17:51:53 +03:00
Owner

Issue

Closes #1

Summary

  • establish canonical AGENTS.md, architecture boundaries, and short-lived issue branch policy
  • add the cross-agent sl Forgejo workflow and full indexed task-memory system
  • add Forgejo issue/PR/squash templates, focused labels, squash-only merging, and protected main

Acceptance Criteria

  • Shared AGENTS.md and cross-agent sl skill are available.
  • GITFLOW.md defines issue branches, squash merges, and cross-review.
  • Forgejo issue and pull request templates reflect the workflow.
  • Task memory initializes, indexes, resumes, closes, and publishes durable knowledge.
  • main rejects direct pushes; a non-author reviewer is requested and a rejected review blocks the merge, while approval itself is advisory.

Verification

  • Python scripts compile; branch and commit validators pass positive/negative cases.
  • Issue-form YAML, Markdown references, symlinks, and JSONL indexes validate locally.
  • Forgejo API reports squash-only merge and source-branch deletion.
  • A direct fast-forward push to main was rejected by the server protection rule.
  • Branch protection reports required_approvals: 0 with rejected-review blocking still enabled.
  • Branch commits are authored by Nikita <me@rznz.dev>, matching the Forgejo account.
  • CI checks are intentionally not required until real Android/Linux/device build workflows exist.

Documentation and architecture

  • README.md, ARCHITECTURE.md, workflow, prompt, and generated knowledge docs are updated or not affected.
  • No secrets, local state, generated debug output, or unrelated changes are included.

AI assistance

  • Prompt log: docs/prompts/1-bootstrap-ai-workflow.md
  • Task outcome: .agents/work/tasks/1-bootstrap-ai-workflow/outcome.md

Review

  • Branch follows <type>/<issue>-<english-kebab-slug>.
  • Work is complete without a feature flag.
  • Teammate review requested from echo1 after the final task-memory commit.
  • Squash message uses docs(issue-1): bootstrap AI development workflow.
## Issue Closes #1 ## Summary - establish canonical `AGENTS.md`, architecture boundaries, and short-lived issue branch policy - add the cross-agent `sl` Forgejo workflow and full indexed task-memory system - add Forgejo issue/PR/squash templates, focused labels, squash-only merging, and protected `main` ## Acceptance Criteria - [x] Shared `AGENTS.md` and cross-agent `sl` skill are available. - [x] `GITFLOW.md` defines issue branches, squash merges, and cross-review. - [x] Forgejo issue and pull request templates reflect the workflow. - [x] Task memory initializes, indexes, resumes, closes, and publishes durable knowledge. - [x] `main` rejects direct pushes; a non-author reviewer is requested and a rejected review blocks the merge, while approval itself is advisory. ## Verification - Python scripts compile; branch and commit validators pass positive/negative cases. - Issue-form YAML, Markdown references, symlinks, and JSONL indexes validate locally. - Forgejo API reports squash-only merge and source-branch deletion. - A direct fast-forward push to `main` was rejected by the server protection rule. - Branch protection reports `required_approvals: 0` with rejected-review blocking still enabled. - Branch commits are authored by `Nikita <me@rznz.dev>`, matching the Forgejo account. - CI checks are intentionally not required until real Android/Linux/device build workflows exist. ## Documentation and architecture - [x] `README.md`, `ARCHITECTURE.md`, workflow, prompt, and generated knowledge docs are updated or not affected. - [x] No secrets, local state, generated debug output, or unrelated changes are included. ## AI assistance - Prompt log: `docs/prompts/1-bootstrap-ai-workflow.md` - Task outcome: `.agents/work/tasks/1-bootstrap-ai-workflow/outcome.md` ## Review - [x] Branch follows `<type>/<issue>-<english-kebab-slug>`. - [x] Work is complete without a feature flag. - [x] Teammate review requested from `echo1` after the final task-memory commit. - [x] Squash message uses `docs(issue-1): bootstrap AI development workflow`.
rznz requested review from echo1 2026-09-20 16:48:48 +03:00
rznz self-assigned this 2026-09-20 17:22:32 +03:00
rznz force-pushed docs/1-bootstrap-ai-workflow from b27fa043f0 to d5a6e3c464 2026-09-20 17:27:34 +03:00 Compare
rznz merged commit 6e1f085fd3 into main 2026-09-20 17:51:53 +03:00
rznz deleted branch docs/1-bootstrap-ai-workflow 2026-09-20 17:51:53 +03:00
Sign in to join this conversation.
No description provided.