AOSSIE-Org · shivansh31414 · Dec 2, 2025 · Dec 8, 2025 · Dec 8, 2025 · Dec 8, 2025
diff --git a/.gitattributes b/.gitattributes
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -0,0 +1,22 @@
+
+
+# Code of Conduct
+
+We are committed to fostering an open and welcoming environment.
+
+## Our Standards
+- Be respectful and inclusive.
+- Use welcoming and professional language.
+- Accept constructive criticism gracefully.
+- Focus on collaboration and learning.
+
+## Unacceptable Behavior
+- Harassment, discrimination, or offensive comments.
+- Publishing private information without consent.
+- Disruptive or hostile conduct.
+
+## Enforcement
+- Report violations via GitHub Issues or email (maintainers will provide contact).
+- Maintainers will review and act fairly.
+- Consequences may include warnings, temporary bans, or permanent removal.
-## Enforcement
- Report violations via GitHub Issues or email (maintainers will provide contact).
- Maintainers will review and act fairly.
- Consequences may include warnings, temporary bans, or permanent removal.
+## Enforcement
+- Report violations via GitHub Issues (use label: `code-of-conduct`) or email: conduct@DebateAI.org
+- Maintainers will review within 5 business days and act fairly.
+- Consequences may include: warnings, temporary bans (1 month+), or permanent removal.
+- Appeals can be submitted to [maintainers email] with additional context.
-## Enforcement
- Report violations via GitHub Issues or email (maintainers will provide contact).
- Maintainers will review and act fairly.
- Consequences may include warnings, temporary bans, or permanent removal.
+## Enforcement
+- Report violations via GitHub Issues (use label: `code-of-conduct`) or email: conduct@DebateAI.org
+- Maintainers will review within 5 business days and act fairly.
+- Consequences may include: warnings, temporary bans (1 month+), or permanent removal.
+- Appeals can be submitted to [maintainers email] with additional context.
+
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,46 @@
+
+
+
+# Contributing to DebateAI
+
+We welcome contributions! Please follow these steps to ensure smooth collaboration.
+
+## Getting Started
+
+1. **Fork the Repository**  
+   Click the Fork button on GitHub and clone your fork:
+   ```bash
+   git clone https://github.com/your-username/DebateAI.git
+   cd DebateAI
+   ```
+
+2. **Create a Branch**  
+   ```bash
+   git checkout -b feature-name
+   ```
+
+3. **Make Changes**  
+   - Follow coding best practices.  
+   - Keep commits atomic and messages clear.
+
+4. **Commit & Push**  
+   ```bash
+   git commit -m "Added [feature/fix]: Short description"
+   git push origin feature-name
+   ```
+
+5. **Open a Pull Request (PR)**  
+   - Provide a detailed description of your changes.  
+   - Link related issues (e.g., `Closes #23`).  
+
+## Best Practices
+
+- **Code Quality**: Ensure your code is clean, readable, and consistent.  
+- **Testing**: Verify changes locally before submitting.  
+- **Security**: Never commit sensitive information (API keys, passwords, etc.).  
+- **Communication**: Be responsive to reviews and open to feedback.  
+
+---
+
+Thank you for helping improve DebateAI! 🚀
+```
diff --git a/DESCRIPTION.md b/DESCRIPTION.md
@@ -0,0 +1,17 @@
+# DebateAI
+
+DebateAI is an AI‑enhanced, real‑time debating platform designed to sharpen communication skills.  
+Users can compete against human opponents or AI challengers in structured formats that mimic formal competitions.
+
+## Why It Exists
+Many learners and professionals want to practice persuasive communication but lack accessible, interactive platforms.  
+DebateAI bridges this gap by combining real‑time debate mechanics with adaptive AI counterarguments.
+
+## Key Features
+- **User vs. User Debates**: Real‑time debates via WebSockets and WebRTC (audio/video/text).
+- **User vs. AI Debates**: LLM‑generated counterarguments that adapt to your input.
+- **Structured Formats**: Opening, cross‑exam, and closing rounds.
+- **Custom Debate Rooms**: Private, topic‑specific spaces for focused practice.
+
+## Vision
+We aim to democratize debate practice, making it engaging, scalable, and accessible to anyone who wants to improve their communication skills.
diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md
@@ -0,0 +1,23 @@
+# Issue Template
+
+## Description
+Briefly describe the problem or feature request.
+
+## Steps to Reproduce (if bug)
+1. Step one
+2. Step two
+3. ...
+
+## Expected Behavior
+What should happen?
+
+## Actual Behavior
+What actually happens?
+
+## Environment
+- OS:
+- Browser:
+- Backend/Frontend version:
+
+## Additional Context
+Add screenshots, logs, or references if available.
diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,16 @@
+# Pull Request Template
+
+## Description
+Explain what this PR changes and why.
+
+## Related Issue(s)
+Closes # (issue number)
+
+## Checklist
+- [ ] Code follows project style guidelines
+- [ ] Tests added or updated
+- [ ] Documentation updated
+- [ ] No sensitive information committed
+
+## Screenshots (if applicable)
+Add before/after visuals or demo links.
diff --git a/SECURITY.md b/SECURITY.md
@@ -0,0 +1,17 @@
+# Security Policy
+
+We take security seriously. Please follow these guidelines when reporting vulnerabilities.
+
+## Reporting a Vulnerability
+-  use GitHub Security tab
+- Include steps to reproduce, impact, and potential fixes.
+- Do not disclose publicly until maintainers confirm a resolution.
+
+## Response Timeline
+- Acknowledge receipt within 48 hours.
+- Provide status updates within 7 days.
+- Aim to release fixes promptly.
+
+## Scope
+- Vulnerabilities in DebateAI backend, frontend, or deployment scripts.
+- Issues affecting user data, authentication, or debate integrity.