Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude/instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -246,5 +246,5 @@ Examples should work across:

---

**Last Updated**: 2026-02-18
**Last Updated**: 2026-02-20
**Purpose**: Guide Claude when working on the MCP server repository and client projects
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -813,4 +813,4 @@ Initial release with core DevOps practices extracted from multiple infrastructur

**Maintainer:** Uttam Jaiswal
**Repository:** devops-practices-mcp
**Last Updated:** 2026-02-17
**Last Updated:** 2026-02-20
26 changes: 13 additions & 13 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Thank you for contributing! This guide will help you understand our workflow and

```bash
# Clone repository to the recommended location
git clone <repo-url> ~/.mcp-servers/devops-practices
git clone https://github.com/ai-4-devops/devops-practices.git ~/.mcp-servers/devops-practices
cd ~/.mcp-servers/devops-practices

# Install dependencies (using modern tooling - recommended)
Expand Down Expand Up @@ -144,8 +144,8 @@ git push origin feature/add-security-practice

**4. Create Merge Request**

- Go to GitLab
- Create MR: `feature/add-security-practice` → `develop`
- Go to GitHub
- Create PR: `feature/add-security-practice` → `develop`
- Wait for CI/CD pipeline to pass
- Request code review
- Address feedback if needed
Expand All @@ -154,7 +154,7 @@ git push origin feature/add-security-practice
**5. Cleanup**

```bash
# After MR is merged
# After PR is merged
git checkout develop
git pull origin develop

Expand Down Expand Up @@ -190,7 +190,7 @@ git checkout develop
git pull origin develop
git checkout -b feature/fix-template-typo

# Fix, commit, create MR → develop
# Fix, commit, create PR → develop
```

**Critical Production Bugs** (hotfix):
Expand All @@ -209,7 +209,7 @@ git add mcp-server.py
git commit -m "Fix critical crash in MCP server template rendering"
git push origin hotfix/mcp-server-crash

# Create MR → main (fast-track approval)
# Create PR → main (fast-track approval)
# After merge to main:

# Also merge to develop
Expand Down Expand Up @@ -254,7 +254,7 @@ All branches run automated checks:

### Requesting Review

**Good MR Description**:
**Good PR Description**:
```markdown
## Summary
Add security best practices covering secrets management, access control, and audit logging.
Expand All @@ -273,7 +273,7 @@ Add security best practices covering secrets management, access control, and aud
Closes #42
```

### Reviewing Others' MRs
### Reviewing Others' PRs

**Check**:
- [ ] Clear, descriptive commit messages
Expand Down Expand Up @@ -330,9 +330,9 @@ git commit -m "Prepare v1.2.0 release"
git push origin release/v1.2.0
```

**3. Create MR → main**
**3. Create PR → main**

- Create MR: `release/v1.2.0` → `main`
- Create PR: `release/v1.2.0` → `main`
- Get approval from team
- Ensure CI/CD passes
- Merge to main
Expand Down Expand Up @@ -498,7 +498,7 @@ feature/WIP # Not clear
- **[git-practices.md](practices/git-practices.md)** - Detailed git workflows

### Questions
- Open an issue on GitLab
- Open an issue on GitHub
- Ask in team Slack channel
- Contact: Uttam Jaiswal (maintainer)

Expand All @@ -525,5 +525,5 @@ feature/WIP # Not clear
---

**Maintained By**: Uttam Jaiswal
**Last Updated**: 2026-02-14
**Version**: 1.2.0
**Last Updated**: 2026-02-20
**Version**: 1.4.0
2 changes: 1 addition & 1 deletion PRACTICE-INDEX.md
Original file line number Diff line number Diff line change
Expand Up @@ -399,5 +399,5 @@ Are you deploying infrastructure?

---

**Last Updated:** 2026-02-17
**Last Updated:** 2026-02-20
**Related:** [README.md](README.md) | [CHANGELOG.md](CHANGELOG.md)
12 changes: 6 additions & 6 deletions QUICK-START.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ network-infra/CLAUDE.md → ~150 lines (only networking-specific)
### MCP Server + CI/CD + Tools
- **mcp-server.py** - Python MCP server (5 tools: list/get practices & templates, render templates)
- **health-check.sh** - Comprehensive validation script (14 checks)
- **.gitlab-ci.yml** - Automated CI/CD pipeline (validates all changes)
- **.github/workflows/ci.yml** - Automated GitHub Actions pipeline (validates all changes)
- **CONTRIBUTING.md** ⭐ - Complete contribution guide with GitLab Flow workflows
- **tools/issue-manager.sh** 🆕 - CLI tool for issue management (Advanced)
- Zero dependencies for MCP server (Python stdlib only)
Expand All @@ -69,7 +69,7 @@ This keeps MCP servers organized and makes configuration easier.

```bash
# Clone to recommended location
git clone <repo-url> ~/.mcp-servers/devops-practices
git clone https://github.com/ai-4-devops/devops-practices.git ~/.mcp-servers/devops-practices
cd ~/.mcp-servers/devops-practices

# Install dependencies (if needed)
Expand Down Expand Up @@ -315,7 +315,7 @@ When creating a new project:
| [CHANGELOG.md](CHANGELOG.md) | Version history and upgrade guides |
| [mcp-server.py](mcp-server.py) | The MCP server (5 tools) |
| [health-check.sh](health-check.sh) | Validation script (14 checks) |
| [.gitlab-ci.yml](.gitlab-ci.yml) | CI/CD pipeline configuration |
| [.github/workflows/ci.yml](.github/workflows/ci.yml) | GitHub Actions pipeline configuration |
| [practices/](practices/) | 10 practice documents |
| [templates/](templates/) | 4 template files |

Expand Down Expand Up @@ -355,7 +355,7 @@ See [CHANGELOG.md](CHANGELOG.md) for complete version history.

**Previous Releases:**
- v1.2.0: GitLab Flow branching, CONTRIBUTING.md, enhanced 02-01-git-practices
- v1.1.0: render_template tool, GitLab CI/CD pipeline
- v1.1.0: render_template tool, GitHub Actions pipeline
- v1.0.0: runbook-documentation, configuration-management, readme-maintenance

---
Expand All @@ -382,5 +382,5 @@ Now that you have the MCP server set up, if you want to contribute improvements:
**Questions?** See [SETUP.md](SETUP.md) for detailed troubleshooting.

**Maintained By**: Uttam Jaiswal
**Last Updated**: 2026-02-17
**Version**: 1.3.0
**Last Updated**: 2026-02-20
**Version**: 1.4.0
Loading