# rohanhong/tmpl.general-repo architecture

> Architecture diagram of the GitHub repository rohanhong/tmpl.general-repo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rohanhong/tmpl.general-repo
- Repository: https://github.com/rohanhong/tmpl.general-repo

## Overview

This repository is a reusable template for setting up Git conventions and agent-assisted repository workflows. A user starts from the template and invokes a skill; the documented branches cover Git operations, project bootstrap and documentation, Python environments, and Hugging Face Hub hosting. The graph follows README-documented responsibilities only: source excerpts were unavailable, so it omits uncertain call-level wiring.

Main entry points: [`.agents/skills/repo-init`](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-init) (Initialize repository), [`.agents/skills/git-commit`](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-commit) (Commit changes), [`.agents/skills/git-branch-create`](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-branch-create) (Create branch), [`.agents/skills/repo-docs`](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-docs) (Generate project docs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_git["Git workflows"]
  node_branch_create["Create branch<br/>[git-branch-create]"]
  node_commit["Commit changes<br/>[git-commit]"]
  node_fetch["Fetch changes<br/>[git-fetch]"]
  node_pull["Pull changes<br/>[git-pull]"]
  node_merge["Merge changes<br/>[git-merge]"]
  node_push["Push changes<br/>[git-push]"]
  node_tag["Manage tags<br/>[git-tag]"]
  node_branch_delete["Delete branch<br/>[git-branch-delete]"]
end

subgraph group_setup["Project setup"]
  node_repo_init["Initialize repository<br/>[repo-init]"]
  node_repo_docs["Generate project docs<br/>[repo-docs]"]
  node_py_env["Set up Python<br/>[py-env-setup]"]
end

subgraph group_hub["Hub hosting"]
  node_hf_setup["Configure Hub hosting<br/>[hf-setup]"]
  node_hf_upload["Upload artifacts<br/>[hf-upload]"]
  node_hf_download["Download artifacts<br/>[hf-download]"]
end

subgraph group_guidance["Shared guidance"]
  node_git_config["Git conventions<br/>[.gitmessage]"]
  node_agent_guide["Agent instructions<br/>[AGENTS.md]"]
end

node_maintainer(("Repository maintainer"))
node_git[("Git repository")]
node_project_files[("Project files")]
node_python_env["Python environment"]
node_hf_hub[("Hugging Face Hub")]

node_maintainer -->|"invokes"| node_branch_create
node_maintainer -->|"invokes"| node_commit
node_maintainer -->|"invokes"| node_fetch
node_maintainer -->|"invokes"| node_pull
node_maintainer -->|"invokes"| node_merge
node_maintainer -->|"invokes"| node_push
node_maintainer -->|"invokes"| node_tag
node_maintainer -->|"invokes"| node_branch_delete
node_maintainer -->|"invokes"| node_repo_init
node_maintainer -->|"invokes"| node_repo_docs
node_maintainer -->|"invokes"| node_py_env
node_maintainer -->|"invokes"| node_hf_setup
node_maintainer -->|"invokes"| node_hf_upload
node_maintainer -->|"invokes"| node_hf_download
node_agent_guide -->|"guides"| node_branch_create
node_agent_guide -->|"guides"| node_repo_init
node_branch_create -->|"operates on"| node_git
node_commit -->|"commits to"| node_git
node_fetch -->|"fetches into"| node_git
node_pull -->|"updates from"| node_git
node_merge -->|"merges into"| node_git
node_push -->|"pushes to"| node_git
node_tag -->|"tags in"| node_git
node_branch_delete -->|"operates on"| node_git
node_commit -->|"follows"| node_git_config
node_repo_init -->|"configures"| node_git
node_repo_init -.->|"offers"| node_repo_docs
node_repo_init -->|"bootstraps"| node_project_files
node_repo_docs -->|"writes"| node_project_files
node_py_env -->|"creates"| node_python_env
node_hf_setup -->|"configures"| node_hf_hub
node_hf_upload -->|"uploads to"| node_hf_hub
node_hf_download -->|"downloads from"| node_hf_hub

click node_branch_create "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-branch-create"
click node_commit "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-commit"
click node_fetch "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-fetch"
click node_pull "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-pull"
click node_merge "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-merge"
click node_push "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-push"
click node_tag "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-tag"
click node_branch_delete "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-branch-delete"
click node_repo_init "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-init"
click node_repo_docs "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-docs"
click node_py_env "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/py-env-setup"
click node_hf_setup "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-setup"
click node_hf_upload "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-upload"
click node_hf_download "https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-download"
click node_git_config "https://github.com/rohanhong/tmpl.general-repo/blob/main/.gitmessage"
click node_agent_guide "https://github.com/rohanhong/tmpl.general-repo/blob/main/AGENTS.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_branch_create,node_commit,node_fetch,node_pull,node_merge,node_push,node_tag,node_branch_delete toneBlue
class node_repo_init,node_repo_docs,node_py_env,node_git,node_project_files,node_hf_hub toneAmber
class node_hf_setup,node_hf_upload,node_hf_download toneMint
class node_git_config,node_agent_guide toneRose
class node_maintainer,node_python_env toneIndigo
```

## Components

### Git workflows

- [Create branch](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-branch-create): `.agents/skills/git-branch-create`
- [Commit changes](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-commit): `.agents/skills/git-commit`
- [Fetch changes](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-fetch): `.agents/skills/git-fetch`
- [Pull changes](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-pull): `.agents/skills/git-pull`
- [Merge changes](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-merge): `.agents/skills/git-merge`
- [Push changes](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-push): `.agents/skills/git-push`
- [Manage tags](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-tag): `.agents/skills/git-tag`
- [Delete branch](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/git-branch-delete): `.agents/skills/git-branch-delete`

### Project setup

- [Initialize repository](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-init): `.agents/skills/repo-init`
- [Generate project docs](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/repo-docs): `.agents/skills/repo-docs`
- [Set up Python](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/py-env-setup): `.agents/skills/py-env-setup`

### Hub hosting

- [Configure Hub hosting](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-setup): `.agents/skills/hf-setup`
- [Upload artifacts](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-upload): `.agents/skills/hf-upload`
- [Download artifacts](https://github.com/rohanhong/tmpl.general-repo/tree/main/.agents/skills/hf-download): `.agents/skills/hf-download`

### Shared guidance

- [Git conventions](https://github.com/rohanhong/tmpl.general-repo/blob/main/.gitmessage): `.gitmessage`
- [Agent instructions](https://github.com/rohanhong/tmpl.general-repo/blob/main/AGENTS.md): `AGENTS.md`

### Other components

- **Repository maintainer**
- **Git repository**
- **Project files**
- **Python environment**
- **Hugging Face Hub**

## Connections

- Repository maintainer → Create branch: invokes
- Repository maintainer → Commit changes: invokes
- Repository maintainer → Fetch changes: invokes
- Repository maintainer → Pull changes: invokes
- Repository maintainer → Merge changes: invokes
- Repository maintainer → Push changes: invokes
- Repository maintainer → Manage tags: invokes
- Repository maintainer → Delete branch: invokes
- Repository maintainer → Initialize repository: invokes
- Repository maintainer → Generate project docs: invokes
- Repository maintainer → Set up Python: invokes
- Repository maintainer → Configure Hub hosting: invokes
- Repository maintainer → Upload artifacts: invokes
- Repository maintainer → Download artifacts: invokes
- Agent instructions → Create branch: guides
- Agent instructions → Initialize repository: guides
- Create branch → Git repository: operates on
- Commit changes → Git repository: commits to
- Fetch changes → Git repository: fetches into
- Pull changes → Git repository: updates from
- Merge changes → Git repository: merges into
- Push changes → Git repository: pushes to
- Manage tags → Git repository: tags in
- Delete branch → Git repository: operates on
- Commit changes → Git conventions: follows
- Initialize repository → Git repository: configures
- Initialize repository → Generate project docs: offers
- Initialize repository → Project files: bootstraps
- Generate project docs → Project files: writes
- Set up Python → Python environment: creates
- Configure Hub hosting → Hugging Face Hub: configures
- Upload artifacts → Hugging Face Hub: uploads to
- Download artifacts → Hugging Face Hub: downloads from