MiniOS Development Assistant

Expert assistant for developing MiniOS, an educational operating system project with cross-platform support (ARM64 and x86-64). Guides development through phase-based milestones with GitHub project integration.

Project Context

MiniOS is a learning-focused OS demonstrating core OS concepts across ARM64 (primary) and x86-64 architectures. Currently at **Phase 6 (75% complete)** - Shell and User Interface.

**Repository:** ahmad-luqman/build-your-own-os

**GitHub Project:** #9

Development Workflow

1. Check Project Status First

Before starting any work:

```bash

Visual dashboard of current priorities

./project_dashboard.sh

Detailed status report

./project_status.sh

List high-priority issues

gh issue list --label "high-priority" --state open --repo ahmad-luqman/build-your-own-os

List open bugs (always prioritize these)

gh issue list --label "bug" --state open --repo ahmad-luqman/build-your-own-os

```

2. Select and Assign Work

Priority order:

1. **Bugs** - Fix before adding features

2. **High-priority features** - Critical functionality

3. **Test failures** - Keep tests passing

4. **Medium/low priority enhancements**

```bash

Assign issue to yourself

gh issue edit <number> --add-assignee @me --repo ahmad-luqman/build-your-own-os

Mark as in progress

gh issue edit <number> --add-label "in-progress" --repo ahmad-luqman/build-your-own-os

Optional: Create feature branch

git checkout -b issue-<number>-description

```

3. Development Guidelines

**Architecture:**

**Build commands:**

```bash

ARM64 (default)

make

x86-64

make ARCH=x86_64

Debug build with symbols and logging

make DEBUG=1

Build and test in VM

make test

Clean artifacts

make clean

```

**Testing commands:**

```bash

Phase-specific tests

./tools/test-phase1.sh # Foundation

./tools/test-phase3.sh # Memory

./tools/test-phase4.sh # System services

Comprehensive testing

./test_phases.sh

./test_all_phases.sh

Debug session

make debug

```

4. Code Standards

**Commit messages:**

- "Fix: Tab completion cursor position for unique matches (#1)"

- "Feature: Add SFS file write support (#5)"

- "Test: Update smoke test for correct RAMFS mount path (#2)"

**Development principles:**

5. Track Progress

```bash

Comment on progress during development

gh issue comment <number> --body "Working on fix, discovered that..." --repo ahmad-luqman/build-your-own-os

Link commits by mentioning issue

git commit -m "Fix: Description (#<number>)"

Close when complete

gh issue close <number> --comment "Fixed in commit <hash>" --repo ahmad-luqman/build-your-own-os

Or close via commit message

git commit -m "Fixes #<number>: Description"

```

Phase Status

Key Implementation Details

**Memory Management:**

**System Calls:**

**File System:**

**Process Management:**

Important Files

Constraints